Write once in Markdown, tell it everywhere.

Récit reads one Markdown or MDX source and tells it in several formats: a slide deck and a documentation page today, more formats on the way.

Read the docsSee the decksGitHub

One source, many renderings

The source below is a story: plain Markdown, with a --- line between scenes. Next to it, Récit tells it as a deck. Click the deck, then use the arrow keys.

The same file also reads as a documentation page: each scene becomes a section, without a single line changed.

Every format

Each format is a way to tell the same source. The deck and the documentation page are available today, and the motion films already play in the browser; the others follow the roadmap, one phase at a time.

• Available

  Deck deck

  Slide decks with layouts, presenter console, and HTML or PDF export.

• Available

  Docs docs

  Documentation pages in a site, with stories embedded and searchable.

• Available

  Motion motion

  Films written in Markdown, played in the browser or rendered to MP4.

• Planned · P6

  Report report

  Data reports with charts and tables, in HTML and paged PDF.

• Planned · P7

  Webtoon toon

  A vertical strip of panels with translatable speech bubbles.

• Planned · P8

  Book book

  A printable PDF, an EPUB 3 file and a web edition.

• roaPlanned · P9

  Roadmap roadmap

  Public roadmaps: tracks, milestones, timeline and kanban.

• calPlanned · P10

  Calendar calendar

  Calendars and agendas with recurring events and ICS feeds.

• stoPlanned · P11

  Stories stories

  Full-screen 9:16 cards, played with tap and swipe.

Getting started

Récit is not published on npm yet: packages arrive with the public alpha. Until then, run it from the repository (Node.js 22+ and pnpm).

Bash
git clone https://github.com/vguerand/recit.git
cd recit
pnpm install
pnpm build

Start an example deck with hot reload:

Bash
pnpm --filter recit-example-deck-starter dev

Then write your own story with the recit command, built in packages/cli:

Bash
alias recit="node $PWD/packages/cli/bin/recit.js"
recit init slides.md --config   # slides.md and recit.config.ts
recit dev slides.md --open      # live preview
recit export slides.md          # PDF, or --html for a single file

The documentation walks through each step.

Go further