Section Headings

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.

Section title syntax
== Level 1 Section Title

=== Level 2 Section Title

==== Level 3 Section Title

===== Level 4 Section Title

====== Level 5 Section Title (maximum level depth)

== 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.

Asciidoctor resources