3. 标题语法

Markdown 支持 6 级标题，通过 # 的数量区分层级，# 后必须加 1 个空格，否则语法不生效。

3.1 基本语法

# 一级标题（对应 HTML h1，文档主标题）

## 二级标题（对应 HTML h2，一级章节）

### 三级标题（对应 HTML h3，二级章节）

#### 四级标题

##### 五级标题

###### 六级标题

3.2 渲染效果

一级标题

1 二级标题

1.1 三级标题

1.1.1 四级标题

1.1.1.1 五级标题

1.1.1.1.1 六级标题

3.3 Setext 风格标题

除了使用 # 符号的 ATX 风格外，Markdown 还支持 Setext 风格的标题，使用下划线表示：

# ATX 风格标题

# Setext 风格一级标题

## Setext 风格二级标题

注意：

• Setext 风格只支持一级和二级标题
• 下划线的长度至少要与标题文本长度相同
• 一级标题使用 = 下划线，二级标题使用 - 下划线

2. 标题级别

3. 标题格式

3.1 标准格式

# 一级标题

## 二级标题

### 三级标题

3.2 注意事项

1. 空格要求：# 后必须加 1 个空格，否则语法不生效
2. 空行建议：标题前后建议保留空行，提高可读性
3. 大小写：标题文本的大小写根据内容需要确定，通常首字母大写
4. 长度：标题长度不宜过长，一般不超过 50 个字符

4. 标题使用技巧

4.1 标题层级规划

• 一级标题：只使用一次，作为文档的主标题
• 二级标题：用于主要章节，如引言、核心内容、总结等
• 三级标题：用于二级标题下的子章节
• 四级及以下：用于更详细的内容分类

4.2 标题命名建议

• 简洁明了：标题应简洁表达章节内容
• 层次分明：标题之间应体现逻辑关系
• 一致性：标题风格应保持一致
• 关键词：标题中应包含关键信息，便于搜索和导航

4.3 自动生成目录

许多 Markdown 编辑器和平台支持根据标题自动生成目录，如：

## 目录

-
-
-
-
-
-

5. 常见问题与解决方案

5.1 标题不生效

问题描述：标题语法不生效，显示为普通文本。 原因分析：# 后缺少空格。 解决方案：在 # 后添加一个空格，如 # 标题。

5.2 标题层级混乱

问题描述：文档结构混乱，标题层级使用不当。 原因分析：标题层级跳跃，如从一级标题直接跳到四级标题。 解决方案：按照层级顺序使用标题，保持层级的连续性。

5.3 标题过长

问题描述：标题过长，影响文档可读性。 原因分析：标题包含过多细节信息。 解决方案：保持标题简洁，将详细信息放在标题下方的正文部分。

6. 总结与最佳实践

6.1 核心概念

• 标题层级：6 级标题，通过 # 的数量区分
• 语法要求：# 后必须加 1 个空格
• 层级规划：合理规划标题层级，保持结构清晰

6.2 最佳实践

1. 标题使用

• 一级标题只使用一次，作为文档主标题
• 按照层级顺序使用标题，保持层级连续
• 标题前后保留空行，提高可读性

2. 标题命名

• 简洁明了，表达章节核心内容
• 保持标题风格一致
• 包含关键词，便于搜索和导航

3. 目录生成

• 为长文档添加目录，便于导航
• 使用页内链接实现目录跳转

6.3 个人实践总结

• 合理规划标题层级，保持文档结构清晰
• 遵循标题语法规则，确保 # 后加空格
• 保持标题简洁明了，突出核心内容
• 为长文档添加目录，提高可读性和导航性