跳转至

章节标题

章节标题一般用来划分章节,便于读者快速浏览和导航。

在 Markdown 中,章节标题有两种写法:井号法和下划线法 ()。井号法支持六级标题,而下划线法只支持两级标题。井号法比下划线法更为常用。

井号法

井号法也叫 ATX 风格,源于 Azron Swartz 在 2002 年编写的轻量级标记语言 ATX。

语法描述

使用 1-6 个井号(#)作为标题行的开头,井号数量代表标题的级别。比如, # 表示这是一个一级标题,### 表示这是一个三级标题。

井号与标题文本之间插入一个空格。

标题行的前面和后面,分别插入至少一个空行。

示例

Markdown
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
# 一级标题

## 二级标题

### 三级标题

#### 四级标题

###### 五级标题

###### 六级标题
输出格式

一级标题

二级标题

三级标题

三级标题

三级标题
六级标题
HTML
1
2
3
4
5
6
<h1>一级标题</h1>
<h2>二级标题</h2>
<h3>三级标题</h3>
<h4>三级标题</h4>
<h5>三级标题</h5>
<h6>六级标题</h6>

下划线法

下划线法也叫 Setext 风格,源于 Ian Feldman 在 1991 年为数码新闻网站 TidBITS 编写的轻量级标记语言 Setext。

语法描述

使用等号(=)和连字符(-)分别表示一级标题和二级标题。

在标题文本的下一行输入一个或多个等号,表示这是一个一级标题。

在标题文本的下一行输入一个或多个连字符,表示这是一个二级标题。

示例

Markdown
1
2
3
4
5
一级标题
=======

二级标题
-------
输出格式

一级标题

二级标题

HTML
1
2
<h1>一级标题</h1>
<h2>二级标题</h2>