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.