标题语法 #

概述 #

标题是文档结构的基础，Markdown 支持六级标题，对应 HTML 的 <h1> 到 <h6> 标签。

基本语法 #

使用 # 号 #

在文本前添加 1-6 个 # 号，# 与文本之间需要有空格。

markdown

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

渲染效果：

一级标题 #

二级标题 #

三级标题 #

四级标题 #

五级标题 #

六级标题 #

标题级别对照 #

Markdown	HTML	用途
`# 标题`	`<h1>`	文档标题
`## 标题`	`<h2>`	章节标题
`### 标题`	`<h3>`	小节标题
`#### 标题`	`<h4>`	段落标题
`##### 标题`	`<h5>`	小标题
`###### 标题`	`<h6>`	注释标题

替代语法 #

一级和二级标题的替代写法 #

一级标题可以在文本下方添加任意数量的 = 号：

markdown

一级标题
=========

一级标题
=

二级标题可以在文本下方添加任意数量的 - 号：

markdown

二级标题
---------

二级标题
-

两种写法的对比 #

特性	`#` 语法	下划线语法
支持级别	1-6级	仅1-2级
可读性	好	更好
推荐程度	推荐	特殊场景

最佳实践 #

标题层级规范 #

markdown

# 文档标题（唯一）

## 第一章

### 1.1 节

#### 1.1.1 小节

### 1.2 节

## 第二章

正确示例 #

markdown

# 项目文档

## 安装指南

### 系统要求

### 安装步骤

## 使用说明

### 基本用法

### 高级用法

错误示例 #

markdown

# 项目文档

### 安装指南    ← 错误：跳过了二级标题

## 使用说明

###### 基本用法  ← 错误：跳级太多

标题使用建议 #

1. 每个文档只有一个一级标题 #

markdown

# 文档标题

内容...

## 章节1

## 章节2

2. 保持层级连续 #

markdown

## 章节

### 小节

#### 细节

3. 标题前后空行 #

markdown

段落内容...

## 新章节

新章节内容...

4. 标题简洁明了 #

markdown

## 安装方法        ← 好

## 关于如何安装这个项目的方法说明  ← 不推荐

目录生成 #

许多 Markdown 解析器支持自动生成目录：

GitHub 风格 #

手动添加目录链接：

markdown

## 目录

- [安装](#安装)
- [使用](#使用)
- [配置](#配置)

自动目录 #

某些解析器支持：

markdown

[toc]

或

[[toc]]

标题锚点 #

标题会自动生成锚点，可用于跳转：

markdown

## 安装指南

跳转到 [安装指南](#安装指南)

锚点命名规则 #

标题	锚点
`## 安装指南`	`#安装指南`
`## Hello World`	`#hello-world`
`## API 文档 v2.0`	`#api-文档-v20`

常见问题 #

问题1：标题不生效 #

原因：# 后面没有空格

markdown

#标题        ← 错误
# 标题       ← 正确

问题2：标题层级混乱 #

原因：跳级使用标题

markdown

# 一级标题
### 三级标题  ← 不推荐：跳过了二级

问题3：标题下划线不显示 #

原因：前面有空行

markdown

标题

---        ← 这会被解析为分割线

标题
---        ← 正确：二级标题

练习 #

尝试编写以下文档结构：

markdown

# 我的第一个 Markdown 文档

## 简介

### 背景

### 目的

## 正文

### 第一章

#### 1.1 节

#### 1.2 节

### 第二章

## 总结

下一步 #

学会了标题语法后，继续学习段落与换行！