HTML 转 PDF 专业版

要解决的问题

把 HTML 变成 PDF 时，常见问题不只是“能导出”，而是中文乱码、CSS 样式丢失、表格和卡片被分页切断、本地文件与网页 URL 的渲染结果不一致。对工程师来说，这通常意味着报告、账单、工单页面在打印或归档时不可用，需要反复手动调整版式。

这个技能把 HTML 转 PDF 做成一个可重复的自动化任务：输入本地 HTML 文件或网络 URL，输出保留视觉结构的 PDF 文件。它适合处理带现代 CSS 的页面，尤其是需要维持颜色、字体、布局、表格完整性的办公文档。

技能如何工作

核心思路是使用浏览器渲染引擎生成 PDF，而不是简单地把 HTML 文本转成页面。推荐路径是 Playwright，它能执行 JavaScript、处理 Grid 与 Flexbox 布局，并更接近真实浏览器打印结果。备选路径是 weasyprint，适合不想引入浏览器运行时的环境，但 CSS 兼容性和系统依赖要求更敏感。

技能的关键能力包括：

• 中文支持：基于 UTF-8 页面内容，配合系统中文字体完成渲染。
• 样式保留：保留颜色、字体、布局等 CSS 样式，适合报告型页面。
• 分页控制：通过打印优化和 CSS 规则减少表格、卡片被切断的情况。
• 参数化输出：可调整页面尺寸、页边距、横向模式，以及是否打印背景色或背景图。
• 输入范围：支持本地 HTML 文件和网络 URL，便于把网页快照转成可分发文档。

实际使用时，可以先从简单调用开始：让技能识别目标 HTML，选择 PDF 输出路径，再按需设置 --format、--margin-top、--print-background 等参数。对于复杂页面，建议在 HTML 中显式指定中文字体，并用打印友好的 CSS 控制元素断页。

适用边界与注意点

这个技能更适合文档化、排版稳定的 HTML 页面，例如报告模板、说明页、列表页和简单数据页。它不是截图工具，也不适合高度依赖动态交互、复杂 Canvas 或实时数据渲染的页面。

需要注意：

• 背景图会影响 PDF 体积，大图片较多时建议压缩图片或关闭背景打印。
• 字体依赖系统环境，如果目标机器缺少对应中文字体，可能出现回退字体或显示差异。
• 长页面需要检查分页行为，避免表格行、卡片组件被拆散。
• 网络 URL可能受登录态、反爬、动态加载影响，导出前应确认页面可以稳定渲染。

整体来看，它的价值在于把“HTML 能显示”转化为“PDF 可交付”，在报告归档、文档导出和跨端打印场景中减少手工排版成本。