首页/新闻资讯/正文详情

wkhtmltopdf 使用指南:把 HTML 网页转成 PDF 的 5 个实用技巧

发布时间:2026/11/11 2:25:25 来源:云帆数科 栏目:资讯中心
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),仅供参考

相关推荐

AI 功能灰度发布实战:从 1% 流量到全量上线,模型路由、监控熔断与快速回滚 一次更新,为什么不能让所有用户替你承担风险? 通过一个可复现的分桶示例、双轨发布架构、可量化的放量闸门与完整的事故复
AI 功能灰度发布实战:从 1% 流量到全量上线,模型路由、监控熔断与快速回滚 一次更新,为什么不能让所有用户替你承担风险? 通过一个可复现的分桶示例、双轨发布架构、可量化的放量闸门与完整的事故复

AI 功能灰度发布实战:从 1% 流量到全量上线,模型路由、监控熔断与快速回滚 一次更新,为什么不能让所有用户替你承担风险? 通过一个可复现的分桶示例、双轨发布架构、可量化的放量闸门与完整的事故复盘,构建真正能够在生产环境使用的 AI 功能发布闭环。 阅读路线 先看事故… · 2026/11/11 2:25:25

破解UEFI变量与ACPI表:NWinfo如何读取Secure Boot证书数据库与BIOS隐藏信息
破解UEFI变量与ACPI表:NWinfo如何读取Secure Boot证书数据库与BIOS隐藏信息

【免费下载链接】nwinfo Hardware information utility for Windows 项目地址: https://gitcode.com/gh_mirrors/nw/nwinfo 点击查看 免费下载 NWinfo 是一款开源的 Windows 硬件信息工具,除了常规的 CPU、内存、磁盘信息外,它还能深入固件层… · 2026/11/5 1:50:14

经典案例拆解:如何把 ResNet 论文编译成结构化 ARA 研究工件(Agent-Native Research Artifact 实战)
经典案例拆解:如何把 ResNet 论文编译成结构化 ARA 研究工件(Agent-Native Research Artifact 实战)

【免费下载链接】Agent-Native-Research-Artifact Research Artifact Protocol for Rigorous and Trustworthy AI Scientists 项目地址: https://gitcode.com/gh_mirrors/ag/Agent-Native-Research-Artifact 点击查看 免费下载 Agent-Native Research Artifact&… · 2026/11/7 11:08:22

北京哪里能审电工证?2026河南最新政策下跨省转证怎么操作
北京哪里能审电工证?2026河南最新政策下跨省转证怎么操作

北京哪里能审电工证?2026河南最新政策下跨省转证怎么操作 之前考的证在外省能不能转过来?这个问题几乎每个持证人都会遇到,尤其是在像北京这样的外来务工人员聚集地。很多人在老家考的电工证,到了北京后却发现无法使用,甚至不知道如何办理转证手续。… · 2026/11/11 2:25:06

陕西省特种工证件查询保姆级教程:学历不高怕报不上名?三门峡市政工人都这么操作!
陕西省特种工证件查询保姆级教程:学历不高怕报不上名?三门峡市政工人都这么操作!

陕西省特种工证件查询保姆级教程:学历不高怕报不上名?三门峡市政工人都这么操作! 你是不是也担心自己学历不高,连特种作业证都报不了名?别慌!在三门峡从事市政公用工程的工友,其实很多人都不是科班出身,但照样能拿到电工证、焊工证、高处作业证等特种… · 2026/11/11 2:25:06

巨野低压电工证怎么考 别踩坑了,这几点你必须知道
巨野低压电工证怎么考 别踩坑了,这几点你必须知道

巨野低压电工证怎么考 别踩坑了,这几点你必须知道 怕考不过白交培训费?别急,巨野低压电工证怎么考,我来给你划重点,少走弯路。… · 2026/11/11 2:25:06

青岛有没有电工证怎么转?含金量高不高
青岛有没有电工证怎么转?含金量高不高

青岛有没有电工证怎么转?含金量高不高 之前考的证在外省能不能转过来?这个问题是很多电工朋友最关心的,尤其是那些已经在外地考取了低压电工证或者高压电工证的朋友。其实,青岛的电工证和全国其他地方的电工证是一样的,都是由应急管理部统一颁发,… · 2026/11/11 2:25:06

巨野低压电工证怎么考官方回应学历不高也能报名
巨野低压电工证怎么考官方回应学历不高也能报名

巨野低压电工证怎么考官方回应学历不高也能报名 你是不是总觉得自己学历不够,考个低压电工证都难?别急,官方回应来了, 学历不是门槛,关键是你有没有实际操作经验… · 2026/11/11 2:25:05

工地太忙根本没时间复习考试?真实经历告诉你电工证考完多久能收到
工地太忙根本没时间复习考试?真实经历告诉你电工证考完多久能收到

工地太忙根本没时间复习考试?真实经历告诉你电工证考完多久能收到 工地太忙根本没时间复习考试,这是几乎所有一线电工从业者的真实经历。尤其是在南阳卧龙区这样的房建工程集中地,工期紧、任务重,很多人在考证过程中只能靠边学边干,甚至靠临时抱佛脚通过… · 2026/11/11 2:24:05

电工证丢失还能补吗?千万别踩坑,丢了证等于失业
电工证丢失还能补吗?千万别踩坑,丢了证等于失业

电工证丢失还能补吗?千万别踩坑,丢了证等于失业 你正在找工作,但手里的电工证突然丢了,这下怎么办?别急,先别慌, 电工证丢失还能补吗 ?答案是肯定的,但 千万别踩坑 ,补办流程如果不了解,可能会耽误你上岗、甚至影响到你的收入。… · 2026/11/10 2:16:10

电力电缆作业证直播报名入口与办理流程良心建议
电力电缆作业证直播报名入口与办理流程良心建议

电力电缆作业证直播报名入口与办理流程良心建议 你是不是也担心学历不高报不了名?别急,今天就给你讲讲 电力电缆作业证直播 的报名流程和那些你必须知道的干货, 良心建议 在这里,别错过。 电力电缆作业证直播报名需要什么条件?… · 2026/11/10 17:46:39

英德电工证报考费多少钱,怕考不过白交培训费?看完这篇别再踩坑
英德电工证报考费多少钱,怕考不过白交培训费?看完这篇别再踩坑

英德电工证报考费多少钱,怕考不过白交培训费?看完这篇别再踩坑 怕考不过白交培训费?英德电工证报考费多少钱,你真的了解吗?现在市面上培训机构五花八门,价格参差不齐,很多人一不小心就花了冤枉钱,结果还考不过。别急,今天就来给你说清楚英德电工证的… · 2026/11/10 17:11:43

_中职电工证最新政策解读
_中职电工证最新政策解读

中职电工证在哪考?工地太忙根本没时间复习考试的救星来了 工地太忙根本没时间复习考试,这是很多正在备考 中职电工证 的建筑工友的真实写照。你不是不想考,而是真的没时间。但别担心,这期内容是 新乡初次报考人员… · 2026/11/11 0:00:52

昆明电工证培训价格值不值得考?老电工告诉你真相
昆明电工证培训价格值不值得考?老电工告诉你真相

昆明电工证培训价格值不值得考?老电工告诉你真相 之前考的证在外省能不能转过来?这个问题是很多在外地打工、换城市生活、或者是想在昆明发展的朋友最关心的。尤其是现在云南发展快,很多企业都在招持证上岗的电工,如果你手头有证但不在本地,那这个证是不… · 2026/11/11 0:00:52

特种电缆张工网上查询全攻略:外省证如何转过来
特种电缆张工网上查询全攻略:外省证如何转过来

特种电缆张工网上查询全攻略:外省证如何转过来 之前考的证在外省能不能转过来?这是很多特种作业从业者最关心的问题,尤其是像特种电缆张工这类证书,直接关系到日常工作是否合规、能否顺利晋升。很多小伙伴因为证书归属地的问题,陷入职业发展的瓶颈,甚至… · 2026/11/11 0:00:52

双极步进电机控制实战:DRV8818PWPR与PIC18F86K22驱动调试
双极步进电机控制实战:DRV8818PWPR与PIC18F86K22驱动调试

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/10 20:19:29

STM32F207ZG + DRV8818PWPR 步进电机驱动实战解析
STM32F207ZG + DRV8818PWPR 步进电机驱动实战解析

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/10 19:22:45

DRV8818PWPR+dsPIC30F4013工业级双极步进电机控制方案
DRV8818PWPR+dsPIC30F4013工业级双极步进电机控制方案

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/10 17:00:47

了解更多?预约专属演示

我们的顾问将为您一对一讲解产品与方案

企业微信二维码