章节标题
在本页面中,您将学到:
-
如何使用AsciiDoc标记章节标题。
标题语法和级别
章节将页面划分为内容层次结构。在AsciiDoc中,使用章节标题来定义章节。
示例 1. 章节标题语法
== 一级标题
=== 二级标题
==== 三级标题
===== 四级标题
====== 五级标题
== 另一个一级标题
当页面转换为HTML时,每个章节标题都会变成一个标题元素,其中标题级别与等号的数量相匹配。例如,一个一级章节(==
)对应一个<h2>
HTML标签。
必须使用Atx风格(单行)来定义章节标题,该风格以一个或多个等号开头。
Antora不识别AsciiDoc中曾经支持的传统Setext风格(即下划线)的标题语法,也不识别Asciidoctor的Markdown风格的标题语法。如果不使用Atx风格语法,页面中的交叉引用将无法解析,并且AsciiDoc的其他功能也将不可用。 |
AsciiDoc和Asciidoctor资源