第 2 章 标题、段落与分隔线

本章覆盖三个语法标识：

2.1 标题

2.1.1 ATX 风格标题（推荐）

行首 1~6 个 #，后接空格与标题文本：

源码：

# 一级标题 H1
## 二级标题 H2
### 三级标题 H3
#### 四级标题 H4
##### 五级标题 H5
###### 六级标题 H6

渲染效果：六个不同级别的标题，级别越高字号越大。

2.1.2 可选：闭合式 ATX

可在行尾再写一组 #（数量无需对应），渲染时被忽略：

源码：

## 二级标题 ##
### 三级标题 ###

渲染效果：等同于普通的二级、三级标题。

2.1.3 Setext 风格标题（旧式）

在正文下加一行 =（H1）或 -（H2）：

源码：

一级标题
=========

二级标题
---------

渲染效果：分别渲染为 H1 与 H2。CommonMark 仍支持但已不推荐使用。

最佳实践：现代文档统一使用 ATX 风格（#），更直观、可读性更好。

2.2 段落

段落之间必须用一个或多个空行分隔：

源码：

这是第一段正文。

这是第二段正文。

渲染效果：两个独立段落。

错误示例（无空行视为同一段）：

这是第一段正文。
这是第二段正文。

渲染效果：两行被合并为同一段落（中间以一个空格相连）。

2.3 换行

2.3.1 软换行（行尾两空格）

源码（注意 ↵ 处行尾有两个空格）：

第一行  ↵
第二行

渲染效果：两行同段但换行显示。

2.3.2 反斜杠换行

源码：

第一行\
第二行

渲染效果：与软换行类似，输出 <br>。

2.3.3 硬换行（GFM）

GFM 允许直接回车即换行（无需两空格）：

第一行
第二行

GFM 渲染：两行间有 <br>。

2.4 分隔线

三种写法等价（需独占一行，行内可有空格）：

源码：

---

***

___

渲染效果：水平分隔线 <hr>。

注意：当 --- 紧接在一段正文下一行时，会被识别为 Setext 二级标题，而非分隔线。须用空行隔开。

源码（陷阱示例）：

正文
---

渲染：H2 标题"正文"。如需分隔线，写为：

正文

---

2.5 综合实例

源码：

# 文档标题

第一段正文，描述本文档目的。

第二段正文，紧接其后是分隔线。

---

## 子章节

第二段中的内容，含软换行：  
行尾两空格的下一行。

渲染效果：H1 标题、两段正文、水平分隔线、H2 子标题、一段含换行的正文。

2.6 小结

• 标题用 #×1~6，ATX 风格为主
• 段落用空行分隔，无空行的相邻行属同段
• 软换行用"行尾两空格"或 \
• 分隔线用 ---、***、___，须独立成行