章节标题

在本页面中,您将学到:

  • 如何使用AsciiDoc标记章节标题。

标题语法和级别

章节将页面划分为内容层次结构。在AsciiDoc中,使用章节标题来定义章节。

示例 1. 章节标题语法
== 一级标题

=== 二级标题

==== 三级标题

===== 四级标题

====== 五级标题

== 另一个一级标题

当页面转换为HTML时,每个章节标题都会变成一个标题元素,其中标题级别与等号的数量相匹配。例如,一个一级章节(==)对应一个<h2> HTML标签。

必须使用Atx风格(单行)来定义章节标题,该风格以一个或多个等号开头。

Antora不识别AsciiDoc中曾经支持的传统Setext风格(即下划线)的标题语法,也不识别Asciidoctor的Markdown风格的标题语法。如果不使用Atx风格语法,页面中的交叉引用将无法解析,并且AsciiDoc的其他功能也将不可用。
AsciiDoc和Asciidoctor资源