presentation-md / web

# presentation-md

> A universal skill that lets AI coding agents generate polished, self-contained HTML slide decks from plain notes. One install. Works across Claude Code, Cursor, Codex, Gemini CLI, and GitHub Copilot.

## What it does

presentation-md gives AI agents a schema-validated workflow for creating slide decks:

1. The agent fills a Deck JSON spec (title, slides, layout, theme)
2. A renderer converts it to a single self-contained HTML file
3. Output opens in any browser — no hosting, no build tool, no export
4. Optional: export to native, editable PowerPoint (`.pptx`), or import an existing `.pptx` back into Deck JSON

## Key facts

- **License:** MIT (free, open source)
- **Version:** npm `@presentation-md/*` (core latest tracks repo releases)
- **Install:** `npx @presentation-md/install <agent>` — one command
- **skills.sh:** `npx skills add isatimur/presentation-md --skill presentation-generator`
- **Claude plugin:** `/plugin marketplace add isatimur/presentation-md` then `/plugin install presentation-md@presentation-md` → `/slides <brief>`
- **Agents supported:** Claude Code, Cursor, GitHub Copilot, OpenAI Codex, Gemini CLI
- **Output format:** Single self-contained HTML file (no external dependencies)
- **Themes:** 75 vibes (`claude` + `default-tech` bundled; 73 more as `@presentation-md/theme-*`); brand import from URL/CSS
- **Layouts:** 18 schema-validated layouts (incl. `ranked-list`, `streak-grid`, `metric-ring`, `chart`, `custom-html`)
- **MCP server:** 13 typed tools (`render_deck`, `export_deck`, `audit_deck`, `judge_deck`, `list_themes`, `apply_theme`, `generate_deck_prompt`, `preview_themes`, `import_pptx`, `import_markdown`, `import_brand_theme`)
- **Import:** PPTX → Deck JSON; Markdown → Deck JSON; brand URL → theme
- **Export:** HTML, editable `.pptx` (PowerPoint / Keynote / Google Slides)
- **Studio:** Browser editor at https://presentation-md.vercel.app/studio
- **npm:** `@presentation-md/install` and sibling packages — https://www.npmjs.com/search?q=%40presentation-md
- **PyPI:** `presentation-md-render` + theme packages — https://pypi.org/search/?q=presentation-md
- **GitHub:** https://github.com/isatimur/presentation-md
- **Distribution:** https://github.com/isatimur/presentation-md/blob/main/docs/distribution/MARKETPLACES.md
- **Author:** Timur Isachenko

## Pricing

Free. MIT licensed. No paid tier, no account required.
https://presentation-md.vercel.app/pricing

## Start here

Install rail (pick agent → copy command): https://presentation-md.vercel.app/#start
Zero-install Studio: https://presentation-md.vercel.app/studio/?example=briefing-signal&fresh=1

## Gallery

75 structured theme proofs plus handcrafted showcase decks — pitch decks, sales proposals, product launches, investor reports, keynotes, and more:
https://presentation-md.vercel.app/#gallery

## Install commands

```
# Recommended — skill + MCP for your agent
npx @presentation-md/install claude-code
npx @presentation-md/install cursor
npx @presentation-md/install copilot
npx @presentation-md/install codex
npx @presentation-md/install gemini-cli

# Universal skills.sh
npx skills add isatimur/presentation-md --skill presentation-generator

# Claude Code plugin
# /plugin marketplace add isatimur/presentation-md
# /plugin install presentation-md@presentation-md
```

## CLI quick reference

```
# Render HTML
npx @presentation-md/render deck.json -o deck.html --theme corporate

# Export PowerPoint
npx @presentation-md/render deck.json --format pptx -o deck.pptx

# Import PowerPoint → Deck JSON
npx @presentation-md/render --from-pptx deck.pptx -o deck.json
```

## Use cases

- Startup pitch decks and investor updates
- Sales proposals and demos
- Product launch presentations
- Internal reviews and team updates
- Conference talks and keynotes
- Any presentation an AI agent needs to produce inside an existing workflow

## How it differs from alternatives

- **vs. Hallmark:** Hallmark is an anti-AI-slop page/UI skill (four verbs, ~20 themes, 57 slop gates). presentation-md is the anti-slop **deck** stack — Deck JSON, 75 themes, MCP craft loop, Studio `?d=` share, editable PPTX. One-prompt decks: `scaffold_deck` → `studio_share_url`. Honest compare: https://presentation-md.vercel.app/vs/hallmark
- **vs. frontend-slides:** Same discovery energy (3 live theme previews); plus schema-validated Deck JSON, 75 structured proofs, PPTX round-trip, 14 MCP tools, and Studio
- **vs. Gamma/Pitch/Tome/Beautiful.ai:** Runs inside the AI agent you already use; output is a portable HTML file you own, not locked to a platform
- **vs. Canva:** Template/design SaaS vs schema-validated Deck JSON from your coding agent
- **vs. reveal.js/Slidev/Marp:** No manual authoring — the agent writes the spec; the renderer handles design
- **vs. raw LLM output:** Schema-validated, consistent, themed — not freeform HTML

## Key pages

- Homepage + gallery: https://presentation-md.vercel.app/
- Studio (browser editor): https://presentation-md.vercel.app/studio/?example=acme
- Comparisons: https://presentation-md.vercel.app/vs/
- vs Hallmark: https://presentation-md.vercel.app/vs/hallmark
- vs frontend-slides: https://presentation-md.vercel.app/vs/frontend-slides
- vs Beautiful.ai: https://presentation-md.vercel.app/vs/beautiful-ai
- vs Gamma: https://presentation-md.vercel.app/vs/gamma
- vs Pitch: https://presentation-md.vercel.app/vs/pitch
- vs Canva: https://presentation-md.vercel.app/vs/canva
- vs Tome: https://presentation-md.vercel.app/vs/tome
- vs Slidev: https://presentation-md.vercel.app/vs/slidev
- vs Marp: https://presentation-md.vercel.app/vs/marp
- Example decks: https://presentation-md.vercel.app/examples/
- npm: https://www.npmjs.com/package/@presentation-md/install
- PyPI: https://pypi.org/project/presentation-md-render/