rendered via .md, wrapped in .prose (same path as /notes pages)
A section heading
The opening paragraph sets the topic. Sentences run a couple of clauses long, mixing bold lead-ins with the occasional italic aside. Inline links thread through the text -- you can hover them, and they pick up the accent color.
A deeper subsection
Sometimes a single h2 needs more structure. h3s break out sub-topics without claiming page-level weight.
A second paragraph follows. It runs long enough that line-height matters: comfortable reading on a 65-character measure means the eye returns cleanly to the next line.
Bulleted lists sit between paragraphs:
- A single-line bullet.
- A bullet with bold to mark its lead-in -- then a clause that runs a sentence long.
- A bullet that itself contains a link so the link treatment looks right inside a list too.
Numbered lists for explicit sequences:
- First, the precondition.
- Then, the move.
- Finally, the consequence.
Block quotes pull a sentence out of the flow. They give a passage different weight -- a callout for someone else's words or a key idea you want the eye to land on.
Inline code appears mid-sentence when a flag or symbol is the thing
under discussion (e.g. the --raw switch). Whole blocks of code earn
their own indent:
.cat --follow --pulse 450
| pulse-keepalive
| frames-to-states
| states-to-html
| to sse
A closing paragraph lands the section. The space below it before the next h2 is the breathing room the page needs.
