html文件怎么转换成pdf文件_HTML转PDF格式转换【指南】-html教程-PHP中文网

wkhtmltopdf 是兼容性最好、行为最可预测的PDF生成方案，适用于无复杂JS渲染或登录态的HTML；需注意file://路径、--enable-local-file-access、UTF-8编码、中文字体及CSS分页控制。

html文件怎么转换成pdf文件_html转pdf格式转换【指南】

用 `wkhtmltopdf` 命令行直接转，最稳

多数人卡在“选哪个工具”，其实只要不涉及复杂 JS 渲染或登录态，wkhtmltopdf 是目前兼容性最好、行为最可预测的方案。它本质是把 WebKit 渲染引擎封装成命令行工具，不是靠 JS 模拟渲染，所以 HTML 里用 float 布局、@media print 样式都能照常生效。

常见错误现象：wkhtmltopdf 报 Exit with code 1 due to network error，大概率是本地路径没加 file:// 前缀，或者 HTML 里引用了远程 CSS/JS 但网络不通。

Windows 下确保路径用正斜杠或双反斜杠：wkhtmltopdf file:///C:/report.html out.pdf
Linux/macOS 要加 file://：wkhtmltopdf file:///home/user/page.html out.pdf
如果 HTML 含相对路径资源（如 ./style.css），必须用 --enable-local-file-access 参数，否则资源加载失败
中文乱码？加 --encoding utf-8 --outline-depth 2，并确认系统已安装中文字体（如 Debian 上装 fonts-wqy-zenhei）

用 `pdfkit`（Python）时别直接传字符串

pdfkit 是 wkhtmltopdf 的 Python 封装，方便集成进脚本，但很多人直接传 HTML 字符串导致样式丢失或编码错乱——它默认按 ASCII 解析，不自动识别 UTF-8。

使用场景：需要动态生成 HTML 再转 PDF，比如报表导出、邮件模板预览。

永远用 open(..., encoding='utf-8') 读文件，再传给 pdfkit.from_file()，别用 .read() 后拼字符串
如果必须从字符串生成，务必加 configuration=pdfkit.configuration(encoding='UTF-8')
注意 pdfkit 不处理 fetch() 或 XMLHttpRequest，JS 渲染的内容不会出现在 PDF 里
超长表格截断？加 CSS：table { page-break-inside: avoid; }，配合 --page-size A4 --margin-top 10

浏览器 DevTools 的 “Print to PDF” 功能不可靠

Chrome / Edge 地址栏点“打印 → 另存为 PDF”，看着方便，但实际用于自动化或批量处理时问题集中：字体嵌入失败、CSS @media screen 规则被忽略、页眉页脚无法关闭、JavaScript 执行时机不可控。

htmlppt.skill

把任意文章或文档内容转换成精美的全屏翻页 HTML 演示文件（幻灯片风格）。当用户发来一篇文章、文档链接、Markdown 内容、或粘贴的文本，并且希望生成演示用的 HTML 时触发。支持任意内容来源：iWiki 链接、KM 链接、本地文件路径、直接粘贴的文本。生成的 HTML 文件保存到本地工作区，并通过企微直接发送给用户。触发词示例：帮我把这篇文章做成PPT、转成演示文档、生成HTML幻灯片、做个演示、转成可以演示的格式、article to deck、make a slide。

下载

典型错误现象：PDF 里显示“Loading...”，或按钮文字变成方块，或分页完全错乱。