# ATX 标题
ATX 标题由一串字符组成,这些字符被解析为内联内容,它们位于 1-6 个未转义的 #
字符的起始序列和任意数量的未转义的 #
字符的可选末尾序列之间。#
字符的起始序列必须后跟空格 (opens new window)或行尾。可选的 #
的末尾序列之前必须有空格,并且只能有空格。起始的 #
字符可以缩进 0-3 个空格。在将标题的原始内容解析为内联内容之前,要先去掉前导空格和后置空格。标题级别等于起始序列中的 #
字符数。
简单的标题:
示例 32
Markdown | HTML | 效果 |
---|---|---|
|
|
超过六个 #
字符就不是标题:
示例 33
Markdown | HTML | 效果 |
---|---|---|
|
|
除非标题为空,否则 #
字符和标题内容之间至少需要一个空格。注意,许多实现目前不需要空格。但是,原始的 ATX 实现 (opens new window)需要此空格,它有助于防止将以下内容解析为标题:
示例 34
Markdown | HTML | 效果 |
---|---|---|
|
|
这不是标题,因为第一个 #
被转义了:
示例 35
Markdown | HTML | 效果 |
---|---|---|
|
|
内容作为内联规则被解析:
示例 36
Markdown | HTML | 效果 |
---|---|---|
|
|
在解析内联内容时忽略前导空格和后置空格:
示例 37
Markdown | HTML | 效果 |
---|---|---|
|
|
允许一到三个空格缩进:
示例 38
Markdown | HTML | 效果 |
---|---|---|
|
|
四个空格太多了:
示例 39
Markdown | HTML | 效果 |
---|---|---|
|
|
示例 40
Markdown | HTML | 效果 |
---|---|---|
|
|
#
字符的末尾序列是可选的:
示例 41
Markdown | HTML | 效果 |
---|---|---|
|
|
它不必与起始序列的长度相同:
示例 42
Markdown | HTML | 效果 |
---|---|---|
|
|
关闭的序列后允许使用空格:
示例 43
Markdown | HTML | 效果 |
---|---|---|
|
|
除了空格 (opens new window)之外的任何 #
字符序列都不是末尾序列,而是作为标题内容的一部分:
示例 44
Markdown | HTML | 效果 |
---|---|---|
|
|
结束序列必须以空格开头:
示例 45
Markdown | HTML | 效果 |
---|---|---|
|
|
反斜杠转义的 #
字符不算作结束序列的一部分:
示例 46
Markdown | HTML | 效果 |
---|---|---|
|
|
ATX 标题不需要用空行与周围内容分开,它们可以中断段落:
示例 47
Markdown | HTML | 效果 |
---|---|---|
|
|
示例 48
Markdown | HTML | 效果 |
---|---|---|
|
|
ATX 标题可以为空:
示例 49
Markdown | HTML | 效果 |
---|---|---|
|
|