On Structure

A page’s headings are its table of contents made visible. Three levels is almost always enough — beyond that, the structure becomes the problem.

The hierarchy

H1 is the page title — one per page. H2 marks major sections, underlined and hard to miss. H3 is a quieter subdivision, bold but without the bar.

H3 is where you stop

If your content needs an H4, your H2 is probably doing too much.

H4 through H6 are deliberately unstyled. They’re there, but reaching for them is a signal to reorganise — not to go deeper.

H4

H5
H6

In practice

Bold for strong emphasis. Italic for stress, titles, or foreign terms. Monospace for code and technical names. Long words and URLs wrap and hyphenate automatically.

Use a rule when a single page has a significant break — a shift in topic, time, or voice. What follows is distinct from what came before. Here, for instance, we shift from headings to lists.


Ordered list
Sequential items where position matters — steps, rankings, instructions
  1. First
  2. Second
  3. Third
Unordered list
Items without meaningful order — features, options, notes
Task list
Checklist items with a completion state
Description list
Term-definition pairs — glossaries, metadata, specifications