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
- First
- Second
- Third
- Unordered list
- Items without meaningful order — features, options, notes
- One
- Two
- Three
- Task list
- Checklist items with a completion state
- Done
- Pending
- Pending
- Description list
- Term-definition pairs — glossaries, metadata, specifications