# 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 | 效果 |
|---|---|---|
|
|