系列名:《从 0 到 1:14 天 Markdown 实战入门(VS Code 版)》 更新节奏:每天 1 章,共 14 章 本章难度:⭐☆☆☆☆ 本章关键词:标题、段落、换行、水平线、注释、转义
1. 本章导读
从这一章开始,我们正式进入 Markdown 语法学习。
如果把写文章比作盖房子,那么标题、段落、换行、水平线就是房子的“骨架”。它们决定了文章的结构是否清晰、层次是否分明、阅读是否顺畅。很多初学者写 Markdown 时,内容不少,但读起来乱,往往就是因为骨架没搭好。
这一章我们会学习 Markdown 中最基础、最常用的一类语法:
- 如何写标题
- 如何分段和换行
- 如何插入水平线
- 如何写注释
- 如何转义特殊字符
这些语法看起来简单,但真正做到规范、一致,需要理解背后的规则和常见坑。
2. 学习目标
完成本章后,你应当能够:
- 使用 ATX 标题和 Setext 标题。
- 理解标题层级的使用原则。
- 正确区分段落、软换行和硬换行。
- 使用水平线分隔内容。
- 在 Markdown 中写 HTML 注释。
- 使用反斜杠转义 Markdown 特殊字符。
- 用这些语法写出结构清晰的技术文章大纲。
- 识别并修正常见的标题与换行错误。
3. 理论讲解
3.1 标题
标题是 Markdown 中最基础的结构语法。它用来表示文章的层级关系。
Markdown 支持两种标题写法:
3.1.1 ATX 标题
ATX 标题用 # 表示层级,# 的数量代表标题级别。
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
渲染效果:

规则:
- # 和标题文字之间必须有空格。
- 最多支持六级标题。
- 建议在标题前后各留一个空行。
- 标题层级不要跳跃,例如从 # 直接到 ###。
正确写法:
# 文章标题
## 第一节
### 1.1 小节
错误写法:
#文章标题
##第一节
3.1.2 Setext 标题
Setext 标题只支持两级:
一级标题
========
二级标题
——–
渲染效果:

规则:
- = 表示一级标题。
- – 表示二级标题。
- 文字下方至少一个 = 或 -,通常写多个更美


