Markdown 标题

Markdown 标题有两种格式。 分别是使用 # 数量表示多级标题方法和 =/- 表示一级和二级标题方法,

使用 # 号标记

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

Markdown 语法 和 HTML 语法对应关系以及渲染效果:

Mardkown 语法 HTML 语法 渲染效果
# 一级标题 <h1>一级标题</h1>

一级标题

## 二级标题 <h2>二级标题</h2>

二级标题

### 三级标题 <h3>三级标题</h3>

三级标题

#### 四级标题 <h4>四级标题</h4>

四级标题

##### 五级标题 <h5>五级标题</h5>
五级标题
###### 六级标题 <h6>六级标题</h6>
六级标题

使用 =- 标记一级和二级标题 (备用语法)

使用 =- 标记一级和二级标题时,在文本的下方添加任意数量的=-字符。

Mardkown 语法 HTML 语法 渲染效果
一级标题
======
<h1>一级标题</h1>

一级标题

二级标题
——–
<h2>二级标题</h2>

二级标题

最佳实践

  • Markdown 解析渲染程序在如何处理数字符号(#)和标题名称之间的空格时并不一致。例如:# 一级标题#一级标题 是否存在空格问题, 有些解析器要求必须有空格,但有些不需要。为了兼容,请始终在数字符号(#)和标题名称之间留一个空格。

  • 在使用 =- 标记一级和二级标题时,原则上任意数量的符号都是可行的,但部分 Markdown 工具不会处理只有一个符号的情形,建议至少使用3个。

  • =-的方式看起来就像是给文字加了一条下划线,有些解析器会解析成水平线。建议使用 # 方式显得更加直观。

  • # 形式的标题可以主动闭合,即文本后面也可以跟#,通常这样做是为了文本看起来更加美观。如## 这里是标题2 ##,标题的级别由开头的#数量决定。

  • # 形式的标题来源于 atx

  • =- 形式的标题来源于 Setext