Markdown 语法速查表

实战片段

要点：① 行内元素（强调、行内代码、链接）必须紧贴文字，块级元素（列表、引用、代码块、表格、分隔线）前面必须有空行 —— 这是 Markdown 不生效的最常见原因；② 嵌套列表用 2–4 个空格，1 个空格在不同渲染器下行为不一致，超过 4 个会变成代码块；③ 表格与删除线不是 CommonMark 标准而是 GitHub 扩展，对外发布前要确认目标平台支持，否则原文符号会裸露；④ 行内代码含反引号要用双反引号包裹；⑤ Markdown 里的特殊字符需要反斜杠转义，否则会被误解析。

<!-- ① 行内元素：紧贴文字，中间不能有空行 -->
这是 **粗体**、这是 *斜体*、这是 ~~删除线~~（非标准）、这是 <code>行内代码</code>。

<!-- ② 块级元素：前面必须有空行 -->
段落一。

- 列表项 A
- 列表项 B
  - 嵌套项（用 2 个空格，不要用 1 个）
    - 再嵌套（不要超过 4 个空格，否则变代码块）

> 引用块
> 第二行
>
> > 嵌套引用

<!-- ③ 代码块：围栏写法是三反引号加语言名；缩进写法是 4 个空格 -->
    function demo() {
      return 1
    }

<!-- ④ 行内代码含反引号时用双反引号包裹 -->
    <code>&#96; &#96;&#96;code&#96;&#96; &#96;</code>

<!-- ⑤ 表格（非 CommonMark 标准） -->
| 语法 | 效果 | 说明 |
| --- | --- | --- |
| **粗体** | 粗体 | 行内元素 |
| [链接](url) | 链接 | 行内元素 |

<!-- ⑥ 链接与图片 -->
[站内链接](/tools.html)
[带 title 的链接](/tools.html "鼠标悬停提示")
![图片 alt](/img/chart.png "图表说明")

<!-- ⑦ 水平线（三连以上减号） -->
---

<!-- ⑧ 转义特殊字符 -->
*不是斜体*  # 不是标题  [不是链接]

<!-- ⑨ 兼容性检查清单（对外发布前） -->
<!-- 基础语法：标题/强调/列表/引用/代码/链接/图片/分隔线 -->
<!-- 扩展语法：表格、删除线、任务列表、emoji 短代码 -->
<!-- 目标平台不支持扩展语法时，原文符号会裸露出来 -->

<!-- 说明：代码块刻意用 4 空格缩进而非围栏 —— 围栏本身就是反引号，
     无法在反引号模板串里自举；行内代码用 code 标签同理。 -->