Skip to content
Skills Library
Documents & office · Conversion & formats

html2pptx

/html2pptx

Convert HTML/WebDeck slide presentations into editable PowerPoint PPTX files using a browser-rendered DOM-to-SVG pipeline and native DrawingML conversion. Use when Codex needs to export .html/.htm slide decks, WebDeck documents, ECharts-heavy decks, or DOM/CSS presentations to editable .pptx while preserving text, shapes, SVG primitives, and chart vectors better than screenshot-based export.

Repository
html2pptx ↗
Licence
MIT
Last repository change
08.06.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
24
Scripts
20
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 08.06.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What to check before installing
  • 20 scripts in this package. Review them before installing, as Claude may execute them.

Scripts: scripts/fontawesome_subset.py, scripts/html2pptx.py, scripts/html_dom_to_editable_svg.js, scripts/svg_to_pptx/__init__.py, scripts/svg_to_pptx/drawingml_context.py, scripts/svg_to_pptx/drawingml_converter.py, scripts/svg_to_pptx/drawingml_elements.py, scripts/svg_to_pptx/drawingml_paths.py

What it does and when to use it

Convert HTML/WebDeck slide presentations into editable PowerPoint PPTX files using a browser-rendered DOM-to-SVG pipeline and native DrawingML conversion. Use when Codex needs to export .html/.htm slide decks, WebDeck documents, ECharts-heavy decks, or DOM/CSS presentations to editable .pptx while preserving text, shapes, SVG primitives, and chart vectors better than screenshot-based export.

Original author description

Convert HTML/WebDeck slide presentations into editable PowerPoint PPTX files using a browser-rendered DOM-to-SVG pipeline and native DrawingML conversion. Use when Codex needs to export .html/.htm slide decks, WebDeck documents, ECharts-heavy decks, or DOM/CSS presentations to editable .pptx while preserving text, shapes, SVG primitives, and chart vectors better than screenshot-based export.

How it works

  1. Quick Start
  2. Recommended Workflow
  3. Output Expectations
  4. Cross-Agent Usage
Original SKILL.md headings · 75 lines, 409 words
SKILL.md preview
---
name: html2pptx
description: Convert HTML/WebDeck slide presentations into editable PowerPoint PPTX files using a browser-rendered DOM-to-SVG pipeline and native DrawingML conversion. Use when Codex needs to export .html/.htm slide decks, WebDeck documents, ECharts-heavy decks, or DOM/CSS presentations to editable .pptx while preserving text, shapes, SVG primitives, and chart vectors better than screenshot-based export.
---

# HTML2PPTX

Use this skill to convert browser-rendered HTML slide decks into editable PPTX.
The bundled pipeline is:

1. `html_dom_to_editable_svg.js`: launch Chromium, render the deck, extract DOM/CSS/SVG/ECharts into editable SVG primitives.
2. `svg_to_pptx`: convert SVG primitives to native PowerPoint DrawingML shapes.
3. `html2pptx.py`: wrapper CLI that runs both steps and validates the generated PPTX structure.

## Quick Start

Run the wrapper script from this skill folder:

```bash
python scripts/html2pptx.py input.html -o output.pptx
```

If Chromium is not discoverable or browser launch fails, pass an executable:

```bash
python scripts/html2pptx.py input.html -o output.pptx \
  --chrome "/path/to/Google Chrome or Chromium"
```

`--chrome-path` is also accepted as an alias. On Windows, prefer:

```bash
python scripts/html2pptx.py examples/basic-deck.html -o basic-deck.pptx \
  --chrome-path "C:/Program Files/Google/Chrome/Application/chrome.exe"
```

Keep intermediate SVG files for debugging:

```bash
python scripts/html2pptx.py input.html -o output.pptx \
  --workdir /tmp/html2pptx-debug --keep-workdir
```

## Recommended Workflow

1. Confirm the input is an HTML slide deck, usually containing `.deck-slide`, `.deck-stage`, `.deck-page`, or similar fixed-size slide containers. Plain single-page HTML is also supported and will be wrapped as one 1280x720 slide automatically.
2. Run `scripts/html2pptx.py`.
3. Inspect the command summary:
   - `pictures=0` is ideal for fully editable output.
   - A large `shapes` count means the deck was converted as native shapes/text.
4. If specific pages look wrong, rerun with `--keep-workdir` and inspect `svg_output/NN_slide.svg`.
5. For malformed source decks, read `references/troubleshooting.md`.

## Output Expectations

The generated PPTX is editable, not pixel-perfect. It preserves:

- Text as editable text boxes where possible.
- Rectangles, lines, circles, paths, and many SVG primitives as editable shapes.
- Rounded boxes with uniform CSS borders as editable rounded rectangles.
- ECharts charts as vector SVG primitives when the chart can render or be rebuilt in SVG mode.
- Common Font Awesome Free solid `<i class="fa-...">` icons as editable SVG paths through an offline subset.
- Speaker notes generated from slide text.

Known limitations:

- Full HTML documents nested inside each slide may still require preprocessing.
- Long scroll-page layouts are clipped to the 1280x720 slide viewport.
- CSS pseudo-elements, filters, shadows, complex masks, unsupported external icon fonts, and advanced gradients may degrade.
- The pipeline requires local Chromium/Chrome and Node.js.

## Cross-Agent Usage

- Codex: invoke this skill as `$html2pptx`, then run `scripts/html2pptx.py`.
- Claude Code: read this `SKILL.md`, then call the same wrapper script.
- opencode: use the wrapper script directly, or follow the repo-level `AGENTS.md` if present.

For project setup and multilingual documentation, use the repository README files outside the skill folder.
Files in this package (24)
  • SKILL.md 3 KB
  • agents/openai.yaml 1 KB
  • references/integration.md 1 KB
  • references/troubleshooting.md 5 KB
  • scripts/fontawesome_subset.py 17 KB
  • scripts/html2pptx.py 13 KB
  • scripts/html_dom_to_editable_svg.js 27 KB
  • scripts/svg_to_pptx/__init__.py 1 KB
  • scripts/svg_to_pptx/drawingml_context.py 4 KB
  • scripts/svg_to_pptx/drawingml_converter.py 12 KB
  • scripts/svg_to_pptx/drawingml_elements.py 53 KB
  • scripts/svg_to_pptx/drawingml_paths.py 13 KB
  • scripts/svg_to_pptx/drawingml_styles.py 20 KB
  • scripts/svg_to_pptx/drawingml_utils.py 10 KB
  • scripts/svg_to_pptx/pptx_builder.py 26 KB
  • scripts/svg_to_pptx/pptx_cli.py 14 KB
  • scripts/svg_to_pptx/pptx_dimensions.py 4 KB
  • scripts/svg_to_pptx/pptx_discovery.py 3 KB
  • scripts/svg_to_pptx/pptx_media.py 2 KB
  • scripts/svg_to_pptx/pptx_narration.py 7 KB
  • scripts/svg_to_pptx/pptx_notes.py 5 KB
  • scripts/svg_to_pptx/pptx_slide_xml.py 5 KB
  • scripts/svg_to_pptx/tspan_flattener.py 2 KB
  • scripts/svg_to_pptx/use_expander.py 4 KB

Versions

RepositoryScoreLicence
This page · GX-Alex/html2pptx100MIT
GX-Alex/html2pptx96MIT

Database snapshot: 13.11.2026 · package version 8af7a299117d (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100pptx
    Create, edit, review, and finalize editable Microsoft PowerPoint .pptx presentations. Use for new decks, source- or template-based presentations, targeted slide edits, charts, tables, images, speaker notes, visual QA, and legacy .ppt conversion. Do not use for HTML/browser…
  • 86html-slide-decks
    Create, edit or convert browser-based slide decks as portable HTML with consistent stage geometry and preserved content. Use for HTML presentations; use the presentations skill for a PowerPoint or Google Slides deliverable.
  • 100ppt-reconstruction
    Reconstruct reference slide images into high-fidelity, editable PowerPoint presentations. Use when a user wants to convert slide screenshots or images into PPTX with native text, shapes, connectors, tables, charts, and reviewed SVG icon suggestions.
  • 100frontend-slides
    Create animation-rich browser-based HTML presentations from scratch, enhance existing HTML decks, or convert PowerPoint files into web presentations. Use only when the requested deliverable is HTML or a browser presentation; do not use when the user needs an editable native .pptx file.
  • 100image-to-editable-ppt
    Rebuild slide images, screenshots, scanned/image-based PPT or PPTX files, and PDF decks into object-level editable PowerPoint (.pptx) — real text boxes, native shapes, native tables, and icons/illustrations re-traced as SVG — preserving page order and speaker notes. Runs fully…
  • 90Presentations
    Read, create or edit PowerPoint or Google Slides decks. Use for presentation, slide deck, PowerPoint, PPT, PPTX, or Google Slides requests.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.