最稳方案是浏览器打印导出pdf；chrome/edge/firefox按ctrl+p选“save as pdf”，无需工具或代码，兼容性好、不上传数据，适合单页html快速转pdf。
直接用浏览器打印功能就能生成可用的 PDF，不需要装额外工具或写代码——这是绝大多数人最省事、兼容性最好的方案。
Chrome / Edge / Firefox 按 Ctrl+P 就能保存为 PDF
这是目前最稳定、对 CSS 和图片支持最好的方式。所有主流桌面浏览器都内置该能力，不依赖网络、不上传 HTML 到第三方服务器。
- 打开目标 HTML 页面（本地文件或网址均可）
- 按
Ctrl+P（Windows/Linux）或Cmd+P（macOS） - 在打印机选项中选
Save as PDF（不是“Microsoft Print to PDF”等系统虚拟打印机） - 点击「保存」，PDF 即生成
注意：若页面含动态内容（如 JS 渲染的表格、图表），请确保页面完全加载后再触发打印；部分 CSS 媒体查询（如 @media print）会影响最终效果，可临时禁用以调试布局。
iText7 html2pdf 在 Java 后端生成高质量 PDF
需要服务端批量生成、嵌入中文字体、或集成进 Spring Boot 应用时，html2pdf 是目前 Java 生态里最成熟的方案。它不是简单截图，而是解析 HTML/CSS 并重构成 PDF 流，因此支持分页、页眉页脚、字体嵌入等专业需求。
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML，替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度，HTML 能同时承载排版、表格、SVG 等。
- Maven 依赖必须用
com.itextpdf:html2pdf，不是旧版itext-asian或xmlworker - 中文显示必须显式注册字体：
fontProvider.addSystemFonts()仅在 Windows 有效；Linux/macOS 需fontProvider.addFont("simhei.ttf")指向实际路径 -
HtmlConverter.convertToPdf()默认不处理相对路径资源（如./style.css或../images/logo.png），建议提前内联 CSS/图片或转为绝对 URL
示例关键调用：HtmlConverter.convertToPdf(htmlContent, outputStream, properties)，其中 properties 必须含 FontProvider 实例，否则中文会变成方块。
Pascalcase HTML to PDF 连接器适合 Power Automate 场景
如果你在用 Microsoft Power Automate 构建自动化流程，且 HTML 来源是 Dataverse、SharePoint 或 HTTP 请求返回的字符串，Pascalcase HTML to PDF 连接器是最轻量的集成选择。
- 输入是纯 HTML 字符串，不支持本地文件路径或 URL 抓取
- 免费版只输出 1 页 PDF；商用需申请 key，上限 5 页 / 每次调用
- 最大接受 15MB HTML 内容，但超 2MB 就容易触发 2 分钟 HTTP timeout，建议先压缩 HTML（移除空格、注释、未用 CSS）
- 错误信息如
HTTP timeout或Failed to parse HTML通常指向结构不规范（如未闭合<div>、含非法实体字符） <p>它返回的是 <code>byte[]，可直接存入 SharePoint 文件库或作为邮件附件，但无法控制页边距、纸张方向等参数。真正麻烦的从来不是“怎么转”，而是“转出来能不能用”：字体缺失、分页断在表格中间、CSS 媒体查询被忽略、JS 渲染内容空白……这些细节往往要反复试三四种方案才能定位。别迷信“一键转换”，先用浏览器打印看效果，再决定是否值得引入后端或 API 方案。
