Markdown 标题

Markdown 标题有两种格式。

1、使用 = 和 - 标记一级和二级标题

= 和 - 标记语法格式如下:

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

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

显示效果如下图:

使用 # 号标记

Markdown 使用 # 号来创建标题,这是从 HTML 的 <h1><h6> 标签概念演化而来的。

使用 # 号可表示 1-6 级标题,一级标题对应一个 # 号,二级标题对应两个 # 号,以此类推。

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

显示效果如下图:

重要注意事项

符号与文字间的空格# 号和标题文字之间必须有一个空格。这是标准的 Markdown 语法要求。

# 正确写法
#错误写法

行首位置# 号必须在行首,前面不能有其他字符(空格或制表符)。

唯一的一级标题:在一个文档中,通常只使用一个一级标题作为文档的主标题,这符合良好的文档结构规范。

标题的嵌套结构

标题的层次结构应该遵循逻辑顺序,不应该跳级使用。良好的标题结构就像一本书的目录:

推荐的层次结构

# 主题:人工智能概述

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

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

避免的错误结构

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

标题编号的最佳实践

自动编号 vs 手动编号

许多 Markdown 处理器和编辑器支持自动生成标题编号,因此在源码中通常不需要手动添加编号:

# 引言
## 背景
## 目标
# 方法论
## 数据收集
## 分析方法

标题锚点

大多数 Markdown 处理器会自动为标题创建锚点(anchor),便于页面内跳转:

[跳转到方法论部分](#方法论)

标题长度建议

  • 保持标题简洁明了,一般不超过 10 个汉字或 20 个英文字符
  • 使用描述性词语,避免模糊的标题如"其他"、"杂项"
  • 可以使用冒号来分隔主题和副主题