<h1 align="center"><b>HTML-TO-PPTX</b></h1>

<p align="center"> <a href="https://www.python.org/"><img src="https://img.shields.io/badge/Python-3.10%2B-3776AB?logo=python&logoColor=white" alt="Python"></a> <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT"></a> <a href="#manual-usage-without-claude-code"><img src="https://img.shields.io/badge/Platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey" alt="Platform"></a> <a href="SKILL.md"><img src="https://img.shields.io/badge/Claude%20Code-skill-D97757" alt="Claude Code skill"></a> </p>

<p align="center">_{📖 <b>English</b> ｜ <a href="README.zh-CN.md">中文</a>}</p>

Convert HTML slide decks into editable `.pptx`: text stays as native PowerPoint textboxes, fonts are subset on demand, complex CSS decorations fall back to local snapshots, and HTML/PPT side-by-side audit material is generated for review.

<table align="center"> <tr> <td width="50%"><img src="assets/compare/yanshi2_html_grid.png" alt="Original HTML rendering"></td> <td width="50%"><img src="assets/compare/yanshi2_ours_grid.png" alt="html-to-pptx output rendered in PowerPoint"></td> </tr> <tr> <td align="center">_{<b>Original HTML</b>}</td> <td align="center">_{<b>html-to-pptx output, opened in PowerPoint</b>}</td> </tr> </table>

<p align="center">_{Text stays as editable vectors; complex decorations are rasterized locally.}</p>

## Why this exists

HTML is a great medium for slide decks — layout, typography, animation, and complex visuals are all more flexible than in PowerPoint. But delivery often requires `.pptx`, and most "HTML → PPT" tools flatten each page into a single image, leaving text uneditable, unsearchable, and pixelated when zoomed.

html-to-pptx avoids the "whole-page screenshot" route. It decomposes HTML into objects PowerPoint understands: text becomes editable textboxes; simple geometry becomes native shapes / lines; effects PP