HTML to PPTX 转换器

将HTML演示文稿（特别是frontend-slides生成的）转换为原生PowerPoint(.pptx)文件。

使用场景

• 将frontend-slides生成的HTML演示文稿转换为可编辑的PPT
• 保留幻灯片结构、文字内容和基本样式
• 批量转换多个HTML文件

使用方法

基本用法

python src/convert.py <input.html> [output.pptx]

示例

# 转换单个文件
python src/convert.py presentation.html

# 指定输出路径
python src/convert.py presentation.html ~/Documents/output.pptx

支持的内容

HTML元素	PPTX转换
---------	---------
	幻灯片页
,	标题
	段落文本
, ,	列表
	文本框分组
	图片（保留路径）
CSS颜色	尝试匹配主题色

转换流程

1. 解析HTML - 使用BeautifulSoup提取slide结构
2. 分析样式 - 提取CSS颜色、字体信息
3. 创建PPTX - 使用python-pptx生成幻灯片
4. 映射内容 - 将HTML元素映射到PPTX形状
5. 保存文件 - 输出.pptx文件

限制说明

• 复杂CSS动画无法转换
• 渐变背景转为纯色
• 自定义字体可能丢失
• 绝对定位元素需要手动调整

依赖安装

pip install python-pptx beautifulsoup4 lxml

文件结构

html2pptx/
├── SKILL.md          # 本文件
├── src/
│   └── convert.py    # 主转换脚本
└── examples/         # 示例文件