Headings
Section titles. @cover is the full-width variant that introduces a major section.
Written as @heading, @cover — one look under several names, so they always match.
@heading
Section titled “@heading”Also written as @h1, @h2, @h3, @h4, @h5, @h6.
Section heading. Write it as # , ## , ### at the start of a line, or as @heading with a level, or as @h1 to @h6. Markdown has six levels and so does this; the type scale has three sizes and stops there, so a level 4, 5 or 6 is set like a level 3 while the document outline still sees the depth you gave it.
Holds text, not other blocks. What goes inside what
@heading OverviewOverview
Settings
| Setting | Type | Required | Default | Meaning |
|---|---|---|---|---|
level | 1 · 2 · 3 · 4 · 5 · 6 | no | 1 | Heading depth, 1 to 6. |
More examples
## Goals and non-goalsGoals and non-goals
@h2 Goals and non-goalsGoals and non-goals
@cover
Section titled “@cover”A band across the page that opens a major section: a title, an optional subtitle, and rules spanning the margin channel. It sits in the flow rather than taking a sheet of its own. For a real title page, follow it with @pagebreak, which already does exactly that and nothing else. Three weights: minimal marks a section, default introduces one, bold puts the type in a tinted field.
Holds text, not other blocks. Goes on the page itself, never inside another block. What goes inside what
@cover Discovery phase
Weeks 1–3Discovery phase
Weeks 1–3
Settings
| Setting | Type | Required | Default | Meaning |
|---|---|---|---|---|
subtitle | string | no | — | Smaller text below the title. Can also be written as the indented line underneath, which is the plainer spelling and the one the examples use. |
style | default · minimal · bold | no | default | How loudly the band announces itself. minimal is one hairline underneath, with the title a size down. default is rules above and below. bold sets the type in a tinted field. |
More examples
@cover(style=minimal) Findings
What the interviews saidFindings
What the interviews said
@cover(style=bold) Part two
Building it
@pagebreakPart two
Building it