1. Markdown 标题
Markdown 标题有两种格式。 分别是使用 #
数量表示多级标题方法和 =/-
表示一级和二级标题方法,
1.1. 使用 # 号标记
使用 #
号可表示 1-6 级标题,一级标题对应一个 #
号,二级标题对应两个 ##
号,以此类推。
Markdown 语法 和 HTML 语法对应关系以及渲染效果:
2.2. 使用 = 和 - 标记一级和二级标题 (备用语法)
使用 =
和 -
标记一级和二级标题时,在文本的下方添加任意数量的=
和 -
字符。
Mardkown 语法 | HTML 语法 | 渲染效果 |
---|---|---|
一级标题 ====== |
<h1>一级标题</h1> |
3. 一级标题 |
二级标题 -------- |
<h2>二级标题</h2> |
3.1. 二级标题 |
3.2. 最佳实践
Markdown 解析渲染程序在如何处理数字符号(#)和标题名称之间的空格时并不一致。例如:# 一级标题
和 #一级标题
是否存在空格问题, 有些解析器要求必须有空格,但有些不需要。为了兼容,请始终在数字符号(#)和标题名称之间留一个空格。
在使用 =
和 -
标记一级和二级标题时,原则上任意数量的符号都是可行的,但部分 Markdown 工具不会处理只有一个符号的情形,建议至少使用3个。
=
和-
的方式看起来就像是给文字加了一条下划线,有些解析器会解析成水平线。建议使用 #
方式显得更加直观。
#
形式的标题可以主动闭合,即文本后面也可以跟#
,通常这样做是为了文本看起来更加美观。如## 这里是标题2 ##
,标题的级别由开头的#
数量决定。
#
形式的标题来源于 atx
=
和 -
形式的标题来源于 Setext