技能介绍

解决什么问题

HTML 静态页面或技术文档转成 PPTX 时，手动复制会丢失标题层级、表格样式、列表结构和代码块可读性。html-to-ppt 针对本地 HTML 文件做自动化转换，把结构化内容落到幻灯片里，减少从文档到演示文稿的重复排版。

技能如何工作

技能读取本地 HTML，依赖 python-pptx、beautifulsoup4、lxml 和 Pillow 完成解析与排版。核心转换规则包括：

h1～h6 作为幻灯片分页标志和标题；
从提取内容生成封面页，使用深色主题；
段落文本自动适配幻灯片宽度；
HTML 表格转换为深色表头和斑马纹；
有序 / 无序列表保留结构；
支持本地相对路径图片与 base64 内嵌图片；
代码块使用等宽字体和灰色背景；
<hr> 转换为视觉分隔线。

不指定输出路径时，默认在 HTML 同目录生成同名 .pptx 文件。

适用边界

它适合结构清晰的 HTML 演示稿、项目说明、指标报告或技术文档初稿，不适合高度复杂的网页布局、交互式组件、CSS 动画或需要精确还原浏览器渲染的页面。由于转换基于标签与语义结构，源 HTML 的标题层级、表格嵌套和图片路径会直接影响 PPTX 结果；建议先确保 HTML 有清晰标题、稳定表格结构和可访问图片。