HTML2Deck

Languages: English · 简体中文 · 繁體中文 · Français · Deutsch · Español · 日本語 · 한국어

Turn HTML into presentation-ready PPTX or PNG — from files, stdin, or URLs, directly from your terminal.

Build once in HTML, then use the same source across decks, visual assets, and automated presentation workflows.

# Free local (default when no valid .lic)
html2deck deck.html -o deck.pptx --mode free

# Premium via Cloud
html2deck deck.html -o deck.pptx --mode cloud --embed-fonts --rebuild-svg --rebuild-chart

# Licensed local
html2deck deck.html -o deck.pptx --mode license -f
# or: html2deck deck.html -o deck.pptx --mode license --license ~/.deckflow/html2deck.lic -f

HTML2Deck fits workflows where content already lives in HTML or can be generated by code:

• Agent-generated presentations — let coding agents author HTML and produce deliverable PPTX or PNG outputs.
• Recurring reports — turn dashboards, metrics, and templated pages into presentation assets from CI or scheduled jobs.
• Web-to-deck reuse — convert hosted pages or ordered HTML files without rebuilding every slide manually.
• Local and cloud execution — run locally with no API key, or use cloud mode for hosted workflows and cloud-only enhancements.

Run without installing:

npx -y @deckflow/html2deck@latest index.html -o deck.pptx

npm install -g @deckflow/html2deck
html2deck --version

Convert a single HTML file (output defaults to the same path and base name):

html2deck index.html
# → index.pptx

Specify an output path:

html2deck index.html -o deck.pptx

Pipe HTML from stdin:

cat index.html | html2deck - -o deck.pptx

Convert multiple HTML files in order:

html2deck page1.html page2.html page3.html -o deck.pptx

Convert a hosted page:

html2deck https://example.com/deck.html -o deck.pptx

Output format is inferred from the -o extension:

html2deck index.html -o frames.png

html2deck index.html --mode free
html2deck index.html --mode license -o deck.pptx
html2deck index.html --mode cloud -o deck.pptx

These flags require --mode cloud or --mode license (Free rejects them with guidance):

html2deck index.html \
  -o deck.pptx \
  --mode cloud \
  --embed-fonts

Local conversion works without an API key. Cloud mode can start as a rate-limited guest; sign in or configure an API key when prompted or when you need authenticated access.

html2deck auth login
html2deck auth status
html2deck config set api-key <key>

For CI, Docker, or agent environments, set the environment variable (takes precedence over stored credentials):

export HTML2DECK_API_KEY=your-api-key

Persistent settings:

Credentials are stored locally at ~/.deckflow/credentials.

--quiet and --verbose cannot be used together. Output format is inferred from the -o extension (pptx or png).

html2deck index.html -o deck.pptx --json

{
  "ok": true,
  "input": ["index.html"],
  "output": "deck.pptx",
  "format": "pptx",
  "mode": "free"
}

Use the package as a library in Node.js. The library returns a Buffer (or PNG image buffers) — it never writes to disk on its own. Write the output yourself, or use the CLI for file output.

import { convertHtmlToPptx } from '@deckflow/html2deck';

const result = await convertHtmlToPptx({
  input: 'index.html',
});
// result.data: Buffer containing the PPTX file
// result.slideCount: number of slides
// result.usedFonts: resolved font names
// result.stats: element/font/simplified statistics
import { writeFileSync } from 'node:fs';
writeFileSync('deck.pptx', result.data);

Start with the quick start, then learn the core concepts. Detailed CLI documentation is available in the docs/cli/ directory.

Install skill/html2deck/ so agents can convert HTML → PPTX without rediscovering CLI flags and slide conventions. See skill/README.md.

Proprietary. See LICENSE for details.