Markdown 语法入门：从标题到表格的 15 个常用写法
写中文博客和笔记，Markdown 真正需要记的语法不超过 15 个。先把其中 7 个用熟，一篇 2000 字的文章就能从头写到尾；表格、代码块、任务列表按需再补。
排版崩掉的原因通常不是语法不会，而是三个细节：空行放错、列表缩进不对、全半角标点混用。下面按「写一篇文章的顺序」讲，最后给一张易错对照表和可直接复制的模板。
先记七个能撑完整篇文章的语法
这七条覆盖一篇普通文章 90% 的排版需求。语法符号都是半角，输入法切到英文再敲。
- 标题：
## 二级标题，井号后要有一个空格。 - 加粗：
**重点**，前后不留空格；斜体用*强调*，中文里少用，辨识度低。 - 无序列表：
- 条目或* 条目，同一篇里只用一种。 - 有序列表：
1. 条目，序号写错也没关系，渲染时按顺序自动编号。 - 链接：
[链接文字](https://example.com)，方括号和圆括号都必须是半角。 - 引用：
> 一句引用，适合放原文摘录或作者自述。 - 分隔线：单独一行写
---，上下都要空行，否则上一行文字会被当成标题。
图片和行内代码属于第二梯队：、`行内代码`。图片的方括号内容是替代文字，别留空，无障碍阅读和 SEO 都要用到。
标题只用两级，层级比数量重要
正文里出现 #（一级标题）是最常见的错误。文章标题本身已经是页面的唯一 H1，正文再从 H1 开始，等于一页出现两个主标题；多数静态站模板会把它降级成 H2，但目录结构会乱。
实用做法：正文只写 ## 和 ###。每个 ## 是一节的结论，### 只在某一节确实需要再分层时才用——连续出现四五个 ###，通常说明该拆成两节了。
标题里不要写「一、二、三」，也不要用「前言」「总结」这类不含信息的词。读者扫目录时，看到的应该是一串能独立成立的判断句。
列表能不能渲染，取决于空行和缩进
Markdown 对列表很挑剔，两个地方最容易出错。
第一，列表前必须有空行。紧贴上一段文字的 - 条目 会被当成段落的一部分，原样输出成一个横杠。
第二，嵌套靠缩进，且子项要对齐父项文字的第一个字。用两个空格或四个空格都行，但同一篇里要保持一致：
- 第一层条目
- 第二层条目（缩进 2 空格）
- 第二层条目
- 第一层条目
1. 有序列表同理
1. 子项缩进 3 空格对齐文字列表项内部要放两段话时，第二段同样要缩进对齐，并在上一行留出空行。这一步做对，长列表才不会塌成一大段。
表格与代码块，是两个最容易被中文弄坏的语法
表格用竖线分隔，第二行是分隔行，必须和表头列数一致：
| 语法 | 写法 | 常见错误 |
| --- | :---: | ---: |
| 表格 | 竖线分隔 | 分隔行列数不一致 |
| 代码块 | 三个反引号 | 反引号数量不匹配 |对齐由分隔行里的冒号决定：--- 默认、:--- 左对齐、:---: 居中、---: 右对齐。中文列宽不齐是正常的——等宽对齐只对纯英文生效，不要在源码里手动补空格凑齐，改一次内容就全乱了。
表格单元格里不能直接换行，也不能直接写竖线；要写竖线用 \| 转义。超过四列的表格在手机上会被横向滚动，能拆成列表就拆。
代码块用三个反引号包裹，第一行写上语言名（php、js、bash），渲染时才会有语法高亮。代码块内部不解析 Markdown，但要注意别从 Word 或聊天窗口粘贴全角空格和中文引号，否则复制出去执行会报错。
中文标点与全半角：Markdown 不处理，渲染会处理
标点是最容易被忽略的一节。Markdown 语法符号必须半角，正文标点应该用中文全角——两套字符混在同一行里，肉眼几乎看不出差别，但会带来三个实际问题。
- 强调符号失效：
**重点 **结尾多一个空格就不生效；**重点**，紧贴中文逗号则正常。 - 链接断掉：中文括号「（）」代替半角圆括号，链接地址不会被识别，会原样显示成一段带方括号的文字。
- 数字与单位被拆行：
10 GB与10GB的换行行为不同，前者可能在数字和单位之间断开。
中英文之间加不加空格，Markdown 本身不管，属于排版约定。目前中文技术写作的通行做法是中英文之间留一个半角空格，具体的标点与空格规则可以另看中文排版规范那一篇，这里只强调一点：同一篇文章里保持一致，比选哪种规则更重要。
15 个语法速查表
| 用途 | 写法 | 容易踩的坑 |
|---|---|---|
| 二级标题 | ## 标题 | 井号后漏空格 |
| 三级标题 | ### 标题 | 跳级使用，目录层级断裂 |
| 加粗 | **文字** | 符号内侧留空格 |
| 斜体 | *文字* | 与中文混排时边界不清 |
| 删除线 | ~~文字~~ | 部分渲染器不支持 |
| 无序列表 | - 条目 | 前面缺空行 |
| 有序列表 | 1. 条目 | 点号后用全角句号 |
| 任务列表 | - [ ] 待办 | 方括号内漏空格 |
| 引用 | > 引用 | 引用内换行没加 > |
| 行内代码 | `代码` | 内容本身含反引号 |
| 代码块 | 三个反引号 + 语言 | 漏写结束标记，吞掉后文 |
| 链接 | [文字](地址) | 用了中文括号 |
| 图片 |  | 说明留空 |
| 表格 | 竖线 + 分隔行 | 分隔行列数不一致 |
| 分隔线 | --- | 上方没空行，变成标题 |
把上面这些固定成习惯的做法，是准备一个模板。新建文件时把下面这段粘进去，替换内容即可；目录由站点模板自动生成，正文里不用手写。
开头三行：结论 + 适用边界 + 读完能得到什么
## 第一个结论式小标题
一段说明（3~4 行）。
- 要点一
- 要点二
## 第二个结论式小标题
| 对比项 | 方案 A | 方案 B |
| --- | --- | --- |
| 成本 | …… | …… |
## 检查清单
1. 有没有多余的一级标题
2. 列表前是否留了空行
3. 表格每行列数是否一致发布前的四项自检
- 空行：每个标题、列表、表格、代码块，前后各留一个空行。
- 层级：正文没有
#，##与###不跳级。 - 列数：表格分隔行与表头列数一致，单元格内没有裸竖线。
- 字符：语法符号是半角，正文标点是全角，没有从 Word 带进来的不可见字符。
把这四条做成习惯，Markdown 就不再是需要专门学的「语法」，而是打字时的一套顺手动作。工具层面怎么选，可以接着看写作软件怎么选；如果你更在意笔记长期留在本地，Obsidian 和 Notion 的取舍那篇讲了文件与数据库的分界。