agentmentoragentmentor

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)

URL: https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax

  • 权威: 官方文档
  • 支撑: 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 个内嵌示例作为一致性测试用例。