Why Marp lives here

• One markdown file per deck — the whole deck is marp/decks/<slug>.md
• Builds to /slides/<slug>/ with no per-deck project
• Diffs like prose, because it is prose

The three slide classes

Set one per slide with <!-- _class: divider -->.

Code reads fine at the back of the room

def build(deck: Path) -> Path:
    out = STATIC / "slides" / deck.stem / "index.html"
    out.parent.mkdir(parents=True, exist_ok=True)
    return out

Anything above ~24 lines will overflow — split the slide instead of shrinking it.

Images and assets

Put deck assets in marp/assets/ and reference them relatively:

![width:520px](../assets/diagram.png)

The build runs with --allow-local-files, so local images are inlined.