GitHub 风格的 Markdown 规范

版本 0.29-gfm (2019-04-06)

此正式规范基于 John MacFarlane 的 CommonMark 规范 (opens new window)，并根据 (opens new window) 授权

• 1. 介绍
  • 1.1 什么是 GitHub 风格的 Markdown 规范？
  • 1.2 什么是 Markdown?
  • 1.3 为什么需要规范？
  • 1.4 关于本文档
• 2. 预热
  • 2.1 字符和行（character&line）
  • 2.2 Tabs
  • 2.3 不安全的字符
• 3. 块和内联
  • 3.1 优先级
  • 3.2 容器块和叶子块(leaf block)
• 4. 叶子块
  • 4.1 专门的换行
  • 4.2 ATX 标题
  • 4.3 Setext 标题
  • 4.4 缩进代码块
  • 4.5 围栏代码块
  • 4.6 HTML 块
  • 4.7 链接引用定义
  • 4.8 段落
  • 4.9 空行
  • 4.10 表格（拓展）
• 5. 容器块
  • 5.1 块引用
  • 5.2 列表项
  • 5.3 任务列表项（拓展）
  • 5.4 列表
• 6. 内联
  • 6.1 反斜杠转义
  • 6.2 实体和数字字符引用
  • 6.3 行内代码
  • 6.4 强调
  • 6.5 删除线（拓展）
  • 6.6 链接
  • 6.7 图片
  • 6.8 自动链接
  • 6.9 自动链接（拓展）
  • 6.10 原生HTML
  • 6.11 无效HTML
  • 6.12 强制换行
  • 6.13 软换行
  • 6.14 文本内容
• 附录：一个解析策略
  • 概述
  • 块结构
  • 内联结构