4.8 Formatting Commands ↑

4.8.9 Generate Sections for Headings

The section-headings command can be used to divide the HTML output into sections, using the section element, with the start of a new section indicated by the presence of a heading of a certain level.

If no heading level is specified, as in the following example, the first heading encountered will set the sectioning heading level.

{:section-headings}

An alternative is to specify the desired sectioning heading level directly, as in the following example.

{:section-headings: 2}

This command should generally be placed at or near the top of the text field, before the appearance of the first heading.

The <section> tags generated will have id attributes supplied, with the literal section-for- being prepended to the Heading ID generated for the triggering heading.