Convert HTML slide decks to editable PowerPoint files using browser-based DOM measurement.

These details have been verified by PyPI

Project links

GitHub Statistics

Maintainers

ojoh02

These details have not been verified by PyPI

Project description

html-to-pptx

Convert HTML slide decks into editable PowerPoint files.

Unlike screenshot-based approaches that produce flat images, html-to-pptx measures every DOM element in a headless browser and maps it to a native PPTX shape — text boxes you can edit, images you can resize, backgrounds you can restyle. The output is a real presentation, not a picture of one.

Install

pip install html-to-pptx
python -m playwright install chromium

Quick start

CLI

html-to-pptx deck.html deck.pptx

Python

import asyncio
from html_to_pptx import convert

asyncio.run(convert("deck.html", "deck.pptx"))

Two-stage API

For more control, separate the measurement and rendering steps:

import asyncio
from html_to_pptx import extract_measurements, render_pptx

async def main():
    # Stage 1: measure DOM elements in a headless browser
    measurements = await extract_measurements("deck.html")

    # Stage 2: render measurements to python-pptx shapes
    prs = render_pptx(measurements)

    # Modify the presentation before saving
    prs.slides[0].shapes[0].text = "Custom title"
    prs.save("deck.pptx")

asyncio.run(main())

HTML format

Your HTML file should contain <section class="slide"> elements at a 1920×1080 canvas:

<!DOCTYPE html>
<html>
<head>
<style>
    * { margin: 0; padding: 0; box-sizing: border-box; }
    body { background: #000; overflow: hidden; }
    .slide {
        width: 1920px;
        height: 1080px;
        display: none;
        flex-direction: column;
        justify-content: center;
        align-items: center;
        font-family: sans-serif;
    }
    .slide.active { display: flex; }
</style>
</head>
<body>

<section class="slide active" style="background-color: #1e293b;">
    <h1 style="font-size: 64px; color: #f8fafc;">Hello World</h1>
</section>

<section class="slide" style="background-color: #ffffff;">
    <p style="font-size: 24px; color: #334155;">Second slide</p>
</section>

</body>
</html>

See examples/demo.html for a full five-slide deck.

What gets converted

HTML feature	PPTX output
Text with fonts, colors, weight, style	Editable text boxes with matching font properties
Background colors	Solid fills (with alpha transparency)
Rounded corners (`border-radius`)	OOXML adjustment guides on rounded rectangles
Base64-embedded images (`data:image/...`)	Native picture shapes
Borders	Shape outlines with color and width
Left-border accent bars	Separate narrow rectangle shapes
`text-transform` (uppercase, etc.)	Transformed text content
Hyperlinks	Preserved on text runs
Ordered/unordered lists	Bullet/number prefixes with marker colors
Element opacity	OOXML alpha on fill colors

How it works

HTML file
    │
    ▼
┌─────────────────────────┐
│  Headless Chromium       │  ← Playwright loads the HTML at 1920×1080
│  (Playwright)            │
│                          │
│  For each .slide:        │
│  • Show slide in isolation│
│  • Clear CSS transforms  │
│  • Measure every visible │
│    element recursively:  │
│    position, size, color,│
│    font, text, images    │
└───────────┬─────────────┘
            │
            ▼
    Measurement tree (JSON)
            │
            ▼
┌─────────────────────────┐
│  python-pptx renderer    │
│                          │
│  For each element:       │
│  • Text leaf → text box  │
│  • Image → picture shape │
│  • Background → rectangle│
│  • Border → outline/shape│
│                          │
│  Coordinates:            │
│  CSS px → inches using   │
│  13.333/1920 ratio       │
└───────────┬─────────────┘
            │
            ▼
      Editable .pptx

Visual comparison tool

Verify conversion quality with side-by-side comparisons:

pip install html-to-pptx[compare]
html-to-pptx-compare deck.html -o results/

This screenshots the original HTML, converts to PPTX, renders the PPTX back to images via LibreOffice, and creates side-by-side comparison PNGs. Requires LibreOffice on PATH.

Output structure:

results/deck/
├── html_slide_0.png      # ground truth (HTML screenshot)
├── html_slide_1.png
├── pptx_slide_0.png      # converter output (PPTX rendered via LibreOffice)
├── pptx_slide_1.png
├── compare_slide_0.png   # side-by-side comparison
├── compare_slide_1.png
└── output.pptx           # the generated file

Limitations

External images are not fetched — use base64 data: URIs for embedded images
CSS background-image on containers is not converted — only <img> tags with base64 src become picture shapes
CSS gradients are captured as the computed backgroundColor (solid), not as gradient fills
Animations and transitions are not represented in PPTX
Font availability — the PPTX references font names from the HTML; if those fonts aren't installed on the machine opening the file, PowerPoint will substitute
Complex CSS layouts (grid, advanced flexbox) are measured as-rendered, but deeply nested layouts may lose some positioning precision

Development

git clone https://github.com/Design-Arena/html-to-pptx.git
cd html-to-pptx
pip install -e ".[dev]"
python -m playwright install chromium
pytest -v

License

MIT

Project details

These details have been verified by PyPI

Project links

GitHub Statistics

Maintainers

ojoh02

These details have not been verified by PyPI

Release history Release notifications | RSS feed

0.2.1

Jun 22, 2026

0.2.0

Jun 22, 2026

This version

0.1.0

Jun 22, 2026

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

html_to_pptx-0.1.0.tar.gz (19.6 kB view details)

Uploaded Jun 22, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

html_to_pptx-0.1.0-py3-none-any.whl (16.9 kB view details)

Uploaded Jun 22, 2026 Python 3

File details

Details for the file html_to_pptx-0.1.0.tar.gz.

File metadata

Download URL: html_to_pptx-0.1.0.tar.gz
Upload date: Jun 22, 2026
Size: 19.6 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for html_to_pptx-0.1.0.tar.gz
Algorithm	Hash digest
SHA256	`b9b6b1ebe6ffa031f9baa074569b9dc60ec50a6f7bfe8e376352395a3f27d797`
MD5	`4a29e427741689aee35dccee5be12ba3`
BLAKE2b-256	`8d7251151b982d65450fa4acf6b37e751a740378292e04c37ac1312dceb9f6e7`

See more details on using hashes here.

Provenance

The following attestation bundles were made for html_to_pptx-0.1.0.tar.gz:

Publisher: publish.yml on Design-Arena/html-to-pptx

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: html_to_pptx-0.1.0.tar.gz
- Subject digest: b9b6b1ebe6ffa031f9baa074569b9dc60ec50a6f7bfe8e376352395a3f27d797
- Sigstore transparency entry: 1906673712
- Sigstore integration time: Jun 22, 2026
Source repository:
- Permalink: Design-Arena/html-to-pptx@6b7e3a417ca8b8c3e5ab1334d7c4d92fcb41014f
- Branch / Tag: refs/tags/v0.1.0
- Owner: https://github.com/Design-Arena
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@6b7e3a417ca8b8c3e5ab1334d7c4d92fcb41014f
- Trigger Event: release

File details

Details for the file html_to_pptx-0.1.0-py3-none-any.whl.

File metadata

Download URL: html_to_pptx-0.1.0-py3-none-any.whl
Upload date: Jun 22, 2026
Size: 16.9 kB
Tags: Python 3
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for html_to_pptx-0.1.0-py3-none-any.whl
Algorithm	Hash digest
SHA256	`350d83e7ac92531ce98c9d9404561ea231db676da4978cd478691a98fd55750a`
MD5	`724c6fb19a9d7e34d98ba0e9b01e0562`
BLAKE2b-256	`ec0e627064538f17a2e290175a4c1fbbf80375182bf0ea9680a899239444f618`

See more details on using hashes here.

Provenance

The following attestation bundles were made for html_to_pptx-0.1.0-py3-none-any.whl:

Publisher: publish.yml on Design-Arena/html-to-pptx

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: html_to_pptx-0.1.0-py3-none-any.whl
- Subject digest: 350d83e7ac92531ce98c9d9404561ea231db676da4978cd478691a98fd55750a
- Sigstore transparency entry: 1906673799
- Sigstore integration time: Jun 22, 2026
Source repository:
- Permalink: Design-Arena/html-to-pptx@6b7e3a417ca8b8c3e5ab1334d7c4d92fcb41014f
- Branch / Tag: refs/tags/v0.1.0
- Owner: https://github.com/Design-Arena
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@6b7e3a417ca8b8c3e5ab1334d7c4d92fcb41014f
- Trigger Event: release

html-to-pptx 0.1.0

Navigation

Verified details

Project links

GitHub Statistics

Maintainers

Unverified details

Meta

Classifiers

Project description

html-to-pptx

Install

Quick start

CLI

Python

Two-stage API

HTML format

What gets converted

How it works

Visual comparison tool

Limitations

Development

License

Project details

Verified details

Project links

GitHub Statistics

Maintainers

Unverified details

Meta

Classifiers

Release history Release notifications | RSS feed

Download files

Source Distribution

Built Distribution

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance