Headings and sections

Structurizr will automatically generate the first two top-level headings for you as follows:

  • Heading level 1: Software system name
  • Heading level 2: Documentation section name (e.g. "1. Context")

For this reason, and depending upon the format being used, specific heading types will be hidden in the rendered content. See this example Markdown file and how it is rendered in Structurizr.

Markdown

When using Markdown, # Heading level 1 and ## Heading level 2 will be hidden in the rendered content, with ### Heading level 3 automatically becoming navigable sub-section headings.

AsciiDoc

When using AsciiDoc, = Document Title (Level 0) and == Level 1 Section Title will be hidden in the rendered content, with === Level 2 Section Title automatically becoming navigable sub-section headings.