StellarDeck

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 next to text becomes 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.

Guide

Getting Started Your first presentation in 5 minutes.

Images & Layouts Splits, backgrounds, columns, and positioning.

Code, Math & Diagrams Syntax highlighting, LaTeX, Mermaid, QR codes.

Autoflow Zero-config layout inference.

Themes & Colors 9 themes, color schemes, custom colors.

Examples

Bean to Bar Chocolate Diagrams, columns, custom backgrounds.

Hand Balancing Split layouts with coach portraits.

Vibe Coding AI-assisted coding and the new developer.

---

GitHub · MIT