章节标题
章节标题一般用来划分章节,便于读者快速浏览和导航。
在 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 |
|
下划线法
下划线法也叫 Setext 风格,源于 Ian Feldman 在 1991 年为数码新闻网站 TidBITS 编写的轻量级标记语言 Setext。
语法描述
使用等号(=
)和连字符(-
)分别表示一级标题和二级标题。
在标题文本的下一行输入一个或多个等号,表示这是一个一级标题。
在标题文本的下一行输入一个或多个连字符,表示这是一个二级标题。
示例
Markdown | |
---|---|
1 2 3 4 5 |
|
输出格式
一级标题
二级标题
HTML | |
---|---|
1 2 |
|