旺小宝 HTML 高质量 PDF 转换

要解决什么问题

很多 HTML 报告、海报或数据可视化页依赖 CSS 渐变、Grid/Flex、背景图和自定义字体。用浏览器「打印为 PDF」或简单 HTML 解析器，经常出现布局错位、背景丢失或字体回退。本技能面向「排版要和浏览器里看到的一致」的场景，把本地 HTML 或 HTTP(S) URL 转成可归档、可分享的 PDF。

如何工作

渲染引擎是 Playwright 无头 Chromium，走真实浏览器排版路径，而不是把 HTML 当纯文本抽出来。

• 输入：source 必填，可以是文件路径（如 report.html）或完整 URL。
• 输出：output 可选；不写则与 HTML 同名生成 .pdf。
• 页面尺寸：--format（默认 A4）、--landscape、或 --width / --height（如 1200px × 1697px）做 1:1 匹配设计稿；优先级为 宽高 > 横向 > 纸张格式。
• 默认 PDF 行为：打印背景开启（保留背景色与渐变），页眉页脚关闭；边距约上/下 15mm、左/右 10mm。

典型流程：确认路径或 URL → 按 HTML 设计宽度选尺寸 → 执行转换 → 检查文件大小并交付。

适用边界与注意点

• 依赖 Python 3.8+ 与已安装的 Playwright + Chromium；环境未就绪时会报 playwright 未找到。
• 若页面靠 JS 异步渲染，内容不全时可加长等待（文档默认约 5 秒）。
• 中文字体依赖系统或 HTML 内字体栈（如 PingFang SC、Microsoft YaHei）；未安装时会出现缺字或回退。
• 含中文的路径可能触发编码问题，建议用规范绝对路径。
• PDF 与 HTML 不一致时，优先用 --width/--height 对齐设计宽度，或在 HTML 里加 打印专用 CSS。