Skip to content

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.

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 Overview

Overview

Settings
SettingTypeRequiredDefaultMeaning
level1 · 2 · 3 · 4 · 5 · 6no1Heading depth, 1 to 6.
More examples
## Goals and non-goals

Goals and non-goals

@h2 Goals and non-goals

Goals and non-goals

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–3

Discovery phase

Weeks 1–3

Settings
SettingTypeRequiredDefaultMeaning
subtitlestringno—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.
styledefault · minimal · boldnodefaultHow 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 said

Findings

What the interviews said

@cover(style=bold) Part two
  Building it

@pagebreak

Part two

Building it