Decks written in Markdown

Récit turns a Markdown (or MDX) file into a slide deck. The deck below is one: click it, then press → to advance, S for the presenter console or T to switch theme.

Click the deck, then use ← → · 5 slides · 00:48Open fullscreen →

Example decks

Every card below is a real deck compiled from the examples/ folder of the repository. Click one to read its page: features, source code and an interactive preview.

Starter

The minimal deck: three slides of plain Markdown, no configuration.

MD3 slides2 layouts
Lorem Ipsum Talk

A conference talk: card grid, quote, Mermaid diagram and speaker notes.

MD5 slides3 layouts
Showcase

Every layout and directive, a full recit.config and a custom component.

MD13 slides9 layouts
Lorem — Product pitch

A 4:3 pitch with a light theme, brand colors, image layouts and fade transitions.

MD6 slides6 layouts
Lorem Ipsum Course

A course handout with KaTeX formulas, tabbed code, a Mermaid diagram and progressive steps.

MD8 slides3 layouts
MDX Deck

An MDX deck: built-in components, stateful React components and expressions.

MDX4 slides3 layouts
Lorem Ipsum Review

A review deck published inside a Récit site, with a sequence diagram.

MD4 slides3 layouts

The deck format

🖥️

Presenter console

Current and next slide, speaker notes, timer and estimated duration, on a second screen.

Learn more→
📱

Smartphone remote

Scan a QR code and drive the deck from your phone on the local network.

Learn more→
🪜

Steps

Reveal lists, cards and answers one by one with :::step blocks.

Learn more→
📝

Speaker notes

A :::notes block per slide, shown in the console and optionally in the PDF.

Learn more→
📄

PDF and HTML export

One PDF page per slide, or a single self-contained HTML file to share anywhere.

Learn more→
∑

KaTeX math

Inline and display formulas written in plain LaTeX, rendered at build time.

Learn more→
🔀

Mermaid diagrams

Flowcharts and sequence diagrams from a fenced code block.

Learn more→
🧩

MDX components

Grid, Card, Callout, Step and your own stateful React components.

Learn more→

Start a deck

  1. Create a deck

    10 s

    recit init writes a starter slides.md (add --config for a recit.config.ts).

    TerminalBash
    npx recit init slides.md

  2. Write with live reload

    1 min

    recit dev serves the deck with hot reload. Add --remote to drive it from your phone.

    TerminalBash
    npx recit dev slides.md

  3. Build a static site

    10 s

    recit build writes index.html and its assets to ./dist, ready for any static host.

    TerminalBash
    npx recit build slides.md

  4. Export

    10 s

    recit export writes a PDF, or a single portable HTML file with --html.

    TerminalBash
    npx recit export slides.md
npx recit export slides.md --html

Prefer a richer starting point? Copy one of the templates. The full syntax is documented on docs.recit.dev.