A worked example

What a page
can be

Most of this site is notes. A note wants to get out of the way. Sometimes a page should be the point.

There are two kinds of thing on this site, and they want opposite treatment.

A note is a unit of thinking. It should look like every other note, because the interesting variation is in the links between them, not the typography. When I write about the strategic staircase, the page’s job is to disappear.

A story is different. The form carries part of the argument. Robin Rendle’s essays do this — the layout isn’t decoration on top of the writing, it is some of the writing.

What this page gives up: nothing

This is the part worth noticing. This page has its own document, its own stylesheet, its own typography — no site chrome reached it. And it is still a normal member of the garden:

Real URL Stamped, permanent, aliased
Tagged design, meta — see the footer
Linkable Both directions, like any note

Those links above aren’t hardcoded. They’re relref, resolved at build time against the content graph — so if a note’s title changes, or its slug moves, this page follows. And if a target disappears, the build fails rather than shipping a dead link.

Proof it works in both directions: here’s a book I read — Wintering — and a film, The Boy and the Heron. Different types, different templates, same graph.

The one rule that still applies

Raw HTML blocks in markdown cannot contain blank lines. CommonMark ends the block at the first gap and reparses the rest as markdown, which is how a hand-built <div> ends up dumping its own source onto the page as code.

Look at the source of this file: every HTML block above is blank-line-free. Not a style preference — a hard requirement.

When to reach for this

Rarely. A story costs more than a note: it’s authored in the repo rather than Obsidian, it needs its own CSS, and it can’t be revised as casually. That price is worth paying when the layout is doing argumentative work, and not otherwise.

The default should stay boring. This is the exception, and exceptions earn their keep by being rare.