Markdown 标题(三)
3.标题
涵盖两种语法、注意事项、层次结构与最佳实践。
Markdown 支持两种标题标记方式。
一、使用 = 和 - 标记
仅一级和二级标题
我展示的是一级标题
=================
我展示的是二级标题
------------------
= 下方划线 → 一级标题(相当于<h1>) -
- 下方划线 → 二级标题(相当于<h2>) - 注意:符号的数量至少一个,通常连续多个以明确表示
二、使用 # 号标记
1~6级标题
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题- 一个
# 对应<h1>,两个# 对应<h2>,依此类推 - 最多六级
三、重要注意事项
| 规则 | 正确 | 错误 |
|---|---|---|
# 与文字之间必须有空格 |
# 标题 |
#标题 |
# 必须在行首,前面不能有空格或制表符 |
# 标题 |
# 标题 |
| 一个文档建议只有一个一级标题(文档主标题) | — | — |
四、标题的逻辑层次
✅ 推荐的层次结构(不跳级):
# 主题:人工智能概述
## 第一部分:基础概念
### 什么是人工智能
### 发展历史
#### 早期发展(1950-1980)
#### 现代发展(1980至今)
## 第二部分:应用领域
### 自然语言处理
### 机器学习
#### 监督学习
#### 无监督学习❌ 应避免的错误结构:
# 主标题
### 直接跳到三级标题 (不推荐,跳过了二级)
## 然后才是二级标题 (顺序错乱)良好的标题层次使文档结构清晰,便于阅读和自动生成目录。
五、标题编号的最佳实践
1. 自动编号(推荐)
多数 Markdown 渲染器(如 Typora、GitHub、VS Code 插件)支持自动生成标题编号,无需手动写编号:
# 引言
## 背景
## 目标
# 方法论渲染后自动显示为 “1. 引言”、“1.1 背景” 等。
2. 标题锚点(页面内跳转)
处理器通常自动为标题生成锚点(小写、空格转短横、去除标点):
[跳转到方法论部分](#方法论)若标题含中文或特殊字符,锚点规则可能因处理器而异。GitHub 风格:#标题文字
3. 标题长度建议
- 简洁明了,一般不超过 10 个汉字 或 20 个英文字符
- 使用描述性词语(避免“其他”、“杂项”)
- 可用冒号分隔主题与副主题,如
# 人工智能:现状与未来
总结速查表
| 标题级别 | 语法示例 |
|---|---|
| 一级 | # 标题 或 标题=== |
| 二级 | ## 标题 或 标题--- |
| 三级 | ### 标题 |
| 四级 | #### 标题 |
| 五级 | ##### 标题 |
| 六级 | ###### 标题 |
关键规则:# 后要有空格,行首无前导空格,层次不跳级,一级标题尽量唯一。