markdown语法书中文版

Markdown 的核心目标是用纯文本表达结构化文档。学习时应先掌握块级语法（标题、段落、列表、代码块），再补行内语法（强调、链接、代码），最后按写作场景组合。判断一份 Markdown 是否合格，标准只有两条：源码可读、渲染结果稳定。

标题与段落

标题用 `#` 到 `######` 表示级别，一级标题通常每篇只用一次，后续从二级标题开始分节。段落之间用空行分隔，不要用连续空格或 Tab 模拟缩进。 行内换行在 CommonMark 中不会渲染为换行，需要行尾两个空格或空行；GFM 可以用单个换行，但建议统一用空行分段，避免不同平台显示不一致。 适用场景：文档结构划分。注意标题层级不要跳级，例如二级下面应接三级，而不是直接到四级。

强调、引用与分隔

粗体用 `文本`，斜体用 `文本`，粗斜体用 `文本`。引用使用 `>`，可以嵌套，适合放摘录、提示或风险说明。分隔线使用 `---` 或 `***`，单独成行。 使用标准：同一段内强调不超过两三处，避免视觉噪音。引用嵌套时每增加一层就多一个 `>`。 注意事项：分隔线前要有空行，否则可能被解析为标题；不要用 `_` 强调包含下划线的词组，兼容性较差。

列表与任务列表

无序列表用 `-`，有序列表用 `1.`、`2.`。嵌套列表缩进 2 到 4 个空格，前后留空行。同一层级的列表符号应保持一致。 任务列表写作 `- [ ] 待办`、`- [x] 完成`，这是 GFM 扩展，CommonMark 不原生支持。在不支持任务列表的平台，它会退化成普通列表，因此跨平台发布前需确认渲染效果。 适用场景：步骤说明、待办事项、检查项。嵌套不要超过三层，否则源码可读性下降。

链接与图片

行内链接写作 `[文字](url "标题")`，参考式链接可把 URL 集中放在文末，便于维护。图片写作 ``，替代文字要能描述图片内容，不能只写“图片”。 判断标准：链接文字应能独立表达去处，避免“点击这里”这类无信息量的表述。GFM 支持自动链接，用尖括号包裹 URL，如 `<https://example.com>`。 注意：URL 中包含空格或特殊字符时，使用百分号编码或尖括号包裹；图片无法加载时，替代文字是唯一可读信息，必须准确。

代码与表格

行内代码用反引号包裹，如 `code`。代码块用三个反引号围住，并标注语言，例如： python print("hello") 表格是 GFM 扩展，使用管道符和分隔行控制对齐： | 名称 | 数量 | 状态 | | --- | :---: | ---: | | A | 1 | 完成 | 单元格内出现管道符 `|` 时，要写成 `\|`。 注意事项：表格每一行列数必须一致；代码块语言标注要正确，否则高亮可能失效；要显示反引号本身时，用双反引号包裹。

转义与平台差异

需要显示 Markdown 符号本身时，用反斜杠转义，例如 `\*` 会显示星号。转义只在普通文本中生效，代码块内不需要转义。 CommonMark 与 GFM 的主要差异：GFM 支持表格、任务列表、删除线 `~~text~~`、自动链接、更宽松的换行处理；CommonMark 仅包含核心语法。发布到静态站点、GitHub、笔记软件前，应确认目标平台支持哪些扩展。 建议：跨平台发布时优先使用 CommonMark 核心语法，确需表格或任务列表再使用 GFM 扩展，并提前测试。 Markdown 的关键不是记住所有符号，而是让源码保持清晰。先写出最小可读文档，再按需增加表格、任务列表等特性，避免过度格式化。发布前检查标题层级、链接地址、图片显示、代码块语言、表格列数和列表缩进，这些基础检查比记住冷门语法更有价值。