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 个英文字符
  • 使用描述性词语(避免“其他”、“杂项”)
  • 可用冒号分隔主题与副主题,如 # 人工智能:现状与未来

总结速查表

标题级别 语法示例
一级 # 标题​ 或 标题===
二级 ## 标题​ 或 标题---
三级 ### 标题
四级 #### 标题
五级 ##### 标题
六级 ###### 标题

关键规则# 后要有空格,行首无前导空格,层次不跳级,一级标题尽量唯一。