GFM(GitHub Flavored Markdown)是 GitHub 在 CommonMark 核心规范之上定义的官方扩展集合,CommonMark 的超集。一句话:GFM = CommonMark + 5 项规范内扩展,另有若干平台级附加渲染能力不在规范内。基础语法见 Markdown。
规范内五项扩展
-
表格 tables
基本结构:
| name | age | |------|-----| | foo | 18 |:控制对齐——:---左、:---:居中、---:右,可混用于同一表:| 左对齐 | 居中 | 右对齐 | |:-------|:------:|-------:| | a | b | c | | 长文本 | 1.5 | 100 |单元格内换行用
<br>;显示字面管道符的转义规则见 Markdown与HTML的关系 -
任务列表 task list items
- [x] 已完成 - [ ] 待办 -
删除线 strikethrough:
~~删除文字~~ -
扩展自动链接 extended autolinks:裸 URL 自动识别为链接,无需
[]()——https://github.com -
标签过滤 tag filtering(Disallowed Raw HTML):自动过滤危险标签(如
<script>)保证安全渲染
平台附加能力(非 GFM 规范)
GitHub 渲染层额外支持:提示块 > [!NOTE] / > [!WARNING]、mermaid 代码块渲染成图、:emoji: 短代码、标题自动锚点。Obsidian 对其中部分(提示块、mermaid)有自己的实现;各引擎解析差异的底层机制见 Markdown与HTML的关系。