标题语法概览

Markdown 标题有两种常见写法：

1. ATX 风格：使用 #，支持 1 到 6 级标题（推荐）。
2. Setext 风格：使用 = 和 -，只支持 1、2 级标题。

ATX 风格（#）

这是最常用、兼容性最好的标题写法。

基本语法

1
2
3
4
5
6

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

渲染效果：

1. # 一级标题（示例）
2. ## 二级标题（示例）
3. ### 三级标题（示例）
4. #### 四级标题（示例）
5. ##### 五级标题（示例）
6. ###### 六级标题（示例）

书写规则

1. # 必须在行首。
2. # 与标题文字之间建议保留一个空格。
3. 一般不建议在标题末尾再补很多 #（可读性较差）。

Setext 风格（= / -）

Setext 只支持两级标题：

1. 一级标题：下一行用 ===
2. 二级标题：下一行用 ---

1
2
3
4
5

我展示的是一级标题
=================

我展示的是二级标题
-----------------

这种写法在短文档中也很常见，但在复杂文档里通常不如 # 风格直观。

标题层级结构

标题层级应遵循从大到小的逻辑，不建议随意跳级。
良好的标题结构就像一本书的目录。

推荐结构

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15

# 主题：人工智能概述

## 第一部分：基础概念
### 什么是人工智能
### 发展历史
#### 早期发展（1950-1980）
#### 现代发展（1980 至今）

## 第二部分：应用领域
### 自然语言处理
### 计算机视觉
### 机器学习
#### 监督学习
#### 无监督学习
#### 强化学习

不推荐结构

1
2
3

# 主标题
### 直接跳到三级标题（不推荐）
## 然后才是二级标题

常见错误

1. # 不在行首，导致无法识别为标题。
2. 标题层级跳跃（如 # 后直接 ###），结构不清晰。
3. 把普通短句都写成标题，导致文档层级过深、阅读困难。
4. 同一篇文档混用过多风格（# 与 =/-）且无规律，影响一致性。