On this page, you’ll learn:
How to mark up section headings with AsciiDoc.
Heading level syntax
Sections partition a page into a content hierarchy. In AsciiDoc, sections are defined using section titles.
Example 1. Section title syntax
== Level 1 Section Title === Level 2 Section Title ==== Level 3 Section Title ===== Level 4 Section Title ====== Level 5 Section Title == Another Level 1 Section Title
When a page is converted to HTML, each section title becomes a heading element where the heading level matches the number of equals signs.
For example, a level 1 section (
==) maps to an
<h2> HTML tag.
Section headings must be defined using the Atx-style (single line) that begins with one or more equals signs. Antora does not recognize the legacy Setext-style (two line) syntax once supported by AsciiDoc. If you use the Setext-style syntax, xrefs in the page will not be resolved and other features of AsciiDoc will not be available.
AsciiDoc and Asciidoctor resources