HTML para PowerPoint Editável
KDevSec/html-to-pptx
Converta HTML em PPTX editável mantendo visual e compatibilidade
Ver no GitHubSkill Claude que converte páginas HTML autocontidas em apresentações PowerPoint editáveis de alta fidelidade. Usa estratégia híbrida: formas e texto nativos para elementos simples, PNGs transparentes para efeitos complexos (vidro fosco, brilhos, gradientes, SVG). Compatível com PowerPoint, Keynote, LibreOffice e Google Slides.
Instalação
npx convez-ai KDevSec/html-to-pptx1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Converter arquiteturas e diagramas HTML em slides editáveis
- Transformar dashboards e infográficos em apresentações
- Gerar decks a partir de layouts web complexos com efeitos CSS
Veredito

Ferramenta sólida para automação de conversão HTML→PPTX com foco em fidelidade visual e editabilidade. Requer Python/Chromium e oferece controle fino via CLI, ideal para fluxos de produção de apresentações programáticas.
README
A tradução para o português deste README ainda está na fila.
html-to-pptx
一个 Claude Code / Agent Skill:把一张自包含的 HTML 页面(架构图、深色玻璃拟态大屏/仪表盘、信息图、海报等)转换成高保真、可编辑的 PowerPoint .pptx,观感与源图一致,并能在 PowerPoint、Keynote、LibreOffice、Google Slides 里正常打开。
核心思路:保真优先的混合策略
PowerPoint 画不出浏览器的某些效果(磨砂玻璃、外发光、复杂渐变、任意 SVG),用原生形状硬凑会显得很平。所以本 skill 对每个元素二分处理:
- 原生(可编辑):凡是 PowerPoint 能 1:1 画的——文字、纯色/线性渐变形状、线条、虚线边框、圆点、徽标。
- 透明 PNG 抠图:凡是它做不出的——磨砂玻璃、辉光、径向/锥形渐变、复杂 SVG 图标、网格/拓扑图、纹理底。
- 文字永远是原生、永远在最上层,所以即使框体是图片,整页文字依然可编辑。
这个二分法也让产物天生跨软件兼容:其它软件会丢失的效果,恰好都被烤进了 PNG(图片到处渲染都一致)。
安装
克隆到你的 Claude skills 目录:
git clone https://github.com/KDevSec/html-to-pptx.git ~/.claude/skills/html-to-pptx
之后当你要求"把某个 HTML 转成可编辑 PPT"时会自动触发。(任何加载 SKILL.md 的 agent 环境都通用。)
前置依赖
构建需要 python-pptx、Pillow、playwright(Chromium)。验证步骤用本机 office 渲染:Windows 用 PowerPoint(pywin32 驱动 COM)、macOS 用 Keynote(AppleScript)、Linux 用 LibreOffice;有原生 office 就不必装 LibreOffice。
不用手动逐个检查,也不用自己装——首次使用直接跑依赖自检,它默认自动安装缺失项(纯标准库,缺啥也能跑):
python scripts/check_deps.py # 默认:自动安装缺失依赖后报告
python scripts/check_deps.py --check # 只报告,不安装
系统包按平台自动装:Linux apt/dnf/pacman+sudo、macOS brew、Windows winget(或 Windows 上装 pywin32 驱动 PowerPoint,免装 LibreOffice)。装不了的会打印手动命令。
用法
指向一个自包含的 .html,然后说:
把这个 html 转成可编辑 PPT(完全复刻)
完整管线(也可手动逐步执行):
SK=~/.claude/skills/html-to-pptx
# 1. 采集几何 + 参考截图
python $SK/scripts/capture.py geom INPUT.html WORK/ --region .slide
# 2a. 保真优先:把"文字+图标"隐藏,截一张完整视觉板
python $SK/scripts/capture.py board INPUT.html WORK/ --hide "<所有文字 + .ic,.ci 选择器>"
# 2b. 或逐元素抠图(让部分框保持可编辑形状)
python $SK/scripts/capture.py slice INPUT.html WORK/ --selectors ".mesh,.glasspanel" --isolate
# 3. 用 scripts/pptx_helpers.py 写 WORK/build.py(背景 → 抠图 → 原生形状 → 原生文字)
# 4. 渲染自检(用本机 office 渲染:PowerPoint/Keynote/LibreOffice)
python $SK/scripts/verify.py OUT.pptx --source INPUT.html --region .slide
python $SK/scripts/verify.py OUT.pptx --open # 直接在你的 office 里打开看
目录说明
| 路径 | 作用 |
|---|---|
SKILL.md | skill 本体:触发条件、决策表(原生 vs PNG)、坐标系、工作流、跨平台说明 |
scripts/capture.py | 无头 Chromium 采集:几何 geom / 保真板 board / 透明抠图 slice |
scripts/pptx_helpers.py | python-pptx 复用库(E/P/rrect/textbox/chip/oval/picture/save/target_cjk_font 等) |
scripts/verify.py | 用本机 office 渲染(PowerPoint COM / Keynote / LibreOffice)+ 源图并排对比 + --open + 可编辑性报告 |
references/playbook.md | 完整方法论:坐标换算、采集技巧、组装配方、踩坑清单 |
字体与跨平台
产物永远是标准 .pptx(不生成 Keynote 的 .key)。默认中文字体为微软雅黑;按受众系统切换用 target_cjk_font('mac'|'linux'),跨机分发可在 PowerPoint 里嵌入字体以彻底锁定观感。渲染自检优先用本机 office(Windows=PowerPoint、macOS=Keynote、Linux=LibreOffice),也就是"在你实际演示的软件里打开看"——verify.py --open 即此;LibreOffice 仅作跨平台兜底。
许可证
Apache-2.0 © 2026 KDevSec