StellarDeck

Markdown presentations for storytellers. Write content, get layouts. Built for agents too.

Get Started View on GitHub

Try it in one command

npm install -g stellardeck && stellardeck --demo

A sample deck opens in your browser. Then stellardeck --preview your-deck.md. More tracks (desktop app, from source) in Getting Started.

Four things shape the project

Storytelling. A deck is a sequence of moments. Markdown’s constraints (one file, short slides, linear order) keep focus on what you’re saying. Reading through the deck feels like reading a script.

Autoflow. Reads each slide’s content and picks a layout. A slide with four short lines gets a Z-pattern. An image with a few words becomes a hero; with more text, a split. Two paragraphs ending in questions become a diagonal. Consecutive slides don’t get the same treatment (anti-monotony).

Agent-native. The CLI takes stdin, exports PDF/PNG/grid, runs batch with --input-dir, and emits typed JSON diagnostics (content overflow, missing images, theme mismatches) that callers can act on without parsing text. The embed API exposes the same via onDiagnostics.

Simple. No build step, no bundler. The .md file is the artifact, PDFs are regenerable. Deckset-compatible.