wkhtmltopdf 使用指南把 HTML 网页转成 PDF 的 5 个实用技巧【免费下载链接】wkhtmltopdfConvert HTML to PDF using Webkit (QtWebKit)项目地址: https://gitcode.com/gh_mirrors/wk/wkhtmltopdf想在服务器或终端里把网页、报表 HTML 文件转成格式规整的 PDF又不想靠浏览器截图对不齐wkhtmltopdf 是一款基于 Qt WebKit 引擎的命令行转换工具一行命令即可把网页渲染成与浏览器几乎一致的 PDF 文档。 核心能力速览它能做什么wkhtmltopdf以及配套的 wkhtmltoimage是一组命令行工具基于 Qt WebKit 引擎渲染 HTML全程 headless 运行无需图形界面或显示器。把单个或一批 HTML 页面合并渲染成一份 PDF支持插入封面页、自动目录TOC和 PDF 书签大纲可加页眉页脚与页码支持 A4 / Letter 等纸张及横纵方向能控制 JavaScript、图片、背景是否加载并调节画质与体积 安装与环境准备最快跑起来的方式是用系统包管理器以 Debian/Ubuntu 为例一行命令即可需安装 fontconfig 与 freetype 字体依赖sudo apt-get install wkhtmltopdf装完运行wkhtmltopdf --version确认版本即可。要获得完整功能建议改用官方预编译包从打包仓库下载对应系统的.deb/.rpm/.pkg/.exe安装即用各发行版说明见 下载文档。注意发行版源里的 wkhtmltopdf 通常使用未打补丁的 Qt会缺少大纲、目录、页眉页脚变量等高级功能想完整体验请使用官方预编译包。 基础用法快速上手命令三条最典型的命令覆盖绝大多数场景# 把一个网页转成 PDF wkhtmltopdf https://example.com out.pdf # 把本地 HTML 文件转成 PDF wkhtmltopdf report.html report.pdf # 在开头插入自动目录再生成正文 wkhtmltopdf toc report.html out.pdf多个页面对象按顺序排在命令行上即可合并成一份文档cover和toc也是对象例如wkhtmltopdf cover.html toc a.html b.html out.pdf。️ 常用参数指南排版、页眉与质量排版与输出参数说明-s, --page-size A4纸张尺寸默认 A4可换 A3 / Letter / Legal-O, --orientation Landscape切换横向排版-T / -B / -L / -R 15mm分别设置上 / 下 / 左 / 右边距页眉页脚参数说明--header-right Page [page] of [topage]右上角显示“第 x 页共 y 页”--footer-center 文档标题底部居中文本--default-header一键默认页眉左页名、右页码内容与质量参数说明--zoom 1.3整体缩放修复内容超出纸面的问题--lowquality降低画质以减小 PDF 体积--javascript-delay 1000等待 JS 渲染完成毫秒 进阶技巧更快更稳只要内容、跳过图片加--no-images不加载图片转换更快适合纯文本报告。批量转换省启动开销用--read-args-from-stdin从标准输入逐行读取参数一个进程处理多份文档如wkhtmltopdf --read-args-from-stdin cmds。自定义目录样式先--dump-default-toc-xsl导出默认 XSL 样式表作为起点再用--xsl-style-sheet my.xsl套上自己的目录样式。等动态内容加载完对依赖 JS 的页面用--window-status done等到脚本把window.status置为指定值后再渲染。⚠️ 常见问题排查中文乱码与图片缺失中文显示为方块现象PDF 里中文全是方框。原因系统缺少中文字体。解决安装 CJK 字体后重跑如sudo apt-get install fonts-noto-cjk并确认输入带--encoding UTF-8。本地 HTML 引用的图片不显示现象本地文件里的图片、子页面一片空白。原因默认禁止本地文件访问。解决加--enable-local-file-access或只放行指定目录--allow ./assets。页面是 JS 动态渲染PDF 却是空的现象内容没加载出来。原因脚本还没跑完就出图了。解决加大--javascript-delay 2000或用--run-script ...在页面加载后手动补执行。 资源导航官方文档与源码入口官方使用文档docs/usage/wkhtmltopdf.txt项目状态与引擎说明docs/status.md下载与发行版说明docs/downloads.md安全AppArmor 策略docs/apparmor.mdC 库 API 文档与示例docs/libwkhtmltox/、examples/从源码获取git clone https://gitcode.com/gh_mirrors/wk/wkhtmltopdf实际编译打包在独立的 packaging 仓库进行【免费下载链接】wkhtmltopdfConvert HTML to PDF using Webkit (QtWebKit)项目地址: https://gitcode.com/gh_mirrors/wk/wkhtmltopdf创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/11/2 1:47:50 · 阅读 1.2k wkhtmltopdf 使用指南：把 HTML 网页转成 PDF 的 5 个实用技巧
wkhtmltopdf 使用指南把 HTML 网页转成 PDF 的 5 个实用技巧【免费下载链接】wkhtmltopdfConvert HTML to PDF using Webkit (QtWebKit)项目地址: https://gitcode.com/gh_mirrors/wk/wkhtmltopdf想在服务器或终端里把网页、报表 HTML 文件转成格式规整的 PDF又不想靠浏览器截图对不齐wkhtmltopdf 是一款基于 Qt WebKit 引擎的命令行转换工具一行命令即可把网页渲染成与浏览器几乎一致的 PDF 文档。 核心能力速览它能做什么wkhtmltopdf以及配套的 wkhtmltoimage是一组命令行工具基于 Qt WebKit 引擎渲染 HTML全程 headless 运行无需图形界面或显示器。把单个或一批 HTML 页面合并渲染成一份 PDF支持插入封面页、自动目录TOC和 PDF 书签大纲可加页眉页脚与页码支持 A4 / Letter 等纸张及横纵方向能控制 JavaScript、图片、背景是否加载并调节画质与体积 安装与环境准备最快跑起来的方式是用系统包管理器以 Debian/Ubuntu 为例一行命令即可需安装 fontconfig 与 freetype 字体依赖sudo apt-get install wkhtmltopdf装完运行wkhtmltopdf --version确认版本即可。要获得完整功能建议改用官方预编译包从打包仓库下载对应系统的.deb/.rpm/.pkg/.exe安装即用各发行版说明见 下载文档。注意发行版源里的 wkhtmltopdf 通常使用未打补丁的 Qt会缺少大纲、目录、页眉页脚变量等高级功能想完整体验请使用官方预编译包。 基础用法快速上手命令三条最典型的命令覆盖绝大多数场景# 把一个网页转成 PDF wkhtmltopdf https://example.com out.pdf # 把本地 HTML 文件转成 PDF wkhtmltopdf report.html report.pdf # 在开头插入自动目录再生成正文 wkhtmltopdf toc report.html out.pdf多个页面对象按顺序排在命令行上即可合并成一份文档cover和toc也是对象例如wkhtmltopdf cover.html toc a.html b.html out.pdf。️ 常用参数指南排版、页眉与质量排版与输出参数说明-s, --page-size A4纸张尺寸默认 A4可换 A3 / Letter / Legal-O, --orientation Landscape切换横向排版-T / -B / -L / -R 15mm分别设置上 / 下 / 左 / 右边距页眉页脚参数说明--header-right Page [page] of [topage]右上角显示“第 x 页共 y 页”--footer-center 文档标题底部居中文本--default-header一键默认页眉左页名、右页码内容与质量参数说明--zoom 1.3整体缩放修复内容超出纸面的问题--lowquality降低画质以减小 PDF 体积--javascript-delay 1000等待 JS 渲染完成毫秒 进阶技巧更快更稳只要内容、跳过图片加--no-images不加载图片转换更快适合纯文本报告。批量转换省启动开销用--read-args-from-stdin从标准输入逐行读取参数一个进程处理多份文档如wkhtmltopdf --read-args-from-stdin cmds。自定义目录样式先--dump-default-toc-xsl导出默认 XSL 样式表作为起点再用--xsl-style-sheet my.xsl套上自己的目录样式。等动态内容加载完对依赖 JS 的页面用--window-status done等到脚本把window.status置为指定值后再渲染。⚠️ 常见问题排查中文乱码与图片缺失中文显示为方块现象PDF 里中文全是方框。原因系统缺少中文字体。解决安装 CJK 字体后重跑如sudo apt-get install fonts-noto-cjk并确认输入带--encoding UTF-8。本地 HTML 引用的图片不显示现象本地文件里的图片、子页面一片空白。原因默认禁止本地文件访问。解决加--enable-local-file-access或只放行指定目录--allow ./assets。页面是 JS 动态渲染PDF 却是空的现象内容没加载出来。原因脚本还没跑完就出图了。解决加大--javascript-delay 2000或用--run-script ...在页面加载后手动补执行。 资源导航官方文档与源码入口官方使用文档docs/usage/wkhtmltopdf.txt项目状态与引擎说明docs/status.md下载与发行版说明docs/downloads.md安全AppArmor 策略docs/apparmor.mdC 库 API 文档与示例docs/libwkhtmltox/、examples/从源码获取git clone https://gitcode.com/gh_mirrors/wk/wkhtmltopdf实际编译打包在独立的 packaging 仓库进行【免费下载链接】wkhtmltopdfConvert HTML to PDF using Webkit (QtWebKit)项目地址: https://gitcode.com/gh_mirrors/wk/wkhtmltopdf创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考