Slides are structured text

• Write in Markdown, keep the deck in git, and review it in a diff.
• Build to a single HTML file with images embedded and no external assets.
• Open it anywhere: a browser, offline, or from an email attachment.

This slide uses the bullets layout: a heading, a list and a closing paragraph.

A small set of marks

A lead line sets the tone and can carry an accent.

• **bold** gives bold, and ***strong*** gives strong.
• ==accent== gives accent, and ((dim)) gives (a muted aside).
• Backticks give code, and markup inside them stays literal: ==like this==.
• [text](url) links out, as to the format reference, in a new tab. [text](#7) jumps to a slide, such as the image layout.
• Indent a line by two spaces to wrap a long item across lines in the source without breaking it on the slide.

From zero to a deck

Install once. After that it's a write, build, present loop.

1. Install: uv tool install akceo
2. Write deck.md: a config block, then slides separated by ---.
3. Build: akceo build deck.md
4. Present: open deck.html and use the arrow keys.

Six layouts

One diagram, the whole slide

%% The same flow as flow.svg, drawn by Mermaid in the deck theme's colors.
flowchart TD
  deck["deck.md<br/>slides in Markdown"] --> build
  theme["theme<br/>built-in or .css file"] --> build
  build(["akceo build<br/>parse · embed images · render"]) --> html["deck.html<br/>one file, no external assets"]