Sources
S1 — Basic Syntax | Markdown Guide
URL: https://www.markdownguide.org/basic-syntax/
- 权威: 权威教程/书
- 支撑: 标题、段落、换行、强调(粗体/斜体)、引用块、列表、行内代码/代码块、水平分割线、链接、图片、转义字符的标准写法。
- 关键事实: 标题用
#数量表示级别(# Heading level 1到###### Heading level 6);粗体写法为**bold text**或__bold text__,斜体写法为*italicized text*或_italicized text_;换行需要在行尾加两个以上空格再回车;无序列表可用-、*或+,同一列表内不要混用。
S2 — Basic writing and formatting syntax(GitHub Docs)
- 权威: 官方文档
- 支撑: GitHub 风格 Markdown(GFM)里任务列表写法、转义规则,以及 Markdown 在真实平台(GitHub)上的应用场景说明。
- 关键事实: 任务列表写法为连字符加空格加
[ ],完成项用[x],例如- [x] #739;转义 Markdown 格式需在字符前加反斜杠\,例如\*our-new-project\*,但该转义对 issue/PR 标题不生效。
S3 — Extended Syntax | Markdown Guide
URL: https://www.markdownguide.org/extended-syntax/
- 权威: 权威教程/书
- 支撑: 表格语法(含对齐方式)与代码块指定语言高亮的写法。
- 关键事实: 表格用短横线
---建表头分隔行、竖线|分隔列;在分隔行两侧加冒号:可控制对齐,:---左对齐、:---:居中、---:右对齐;代码块三个反引号后紧跟语言名(如 ```json)即可触发对应语言高亮。
S4 — CommonMark Spec(current)
URL: https://spec.commonmark.org/current/
- 权威: 官方文档
- 支撑: Markdown 语法标准化的背景,说明本课教的语法是跨平台通用的核心子集,而非某个特定网站的私有规则。
- 关键事实: CommonMark 是 Markdown 语法的标准化规范,由 John MacFarlane 主导整理,目的是让 Markdown 文档在不同解析器和平台间渲染结果一致;spec 包含超过 500 个内嵌示例作为一致性测试用例。