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

wkhtmltopdf HTML转PDF 实战指南:从 HTML 文件到成品 PDF

发布时间:2026/11/2 15:03:31 来源:云帆数科 栏目:资讯中心
wkhtmltopdf HTML转PDF 实战指南:从 HTML 文件到成品 PDF
wkhtmltopdf HTML转PDF 实战指南从 HTML 文件到成品 PDF【免费下载链接】wkhtmltopdfConvert HTML to PDF using Webkit (QtWebKit)项目地址: https://gitcode.com/gh_mirrors/wk/wkhtmltopdfwkhtmltopdf 是一款基于 QT Webkit 渲染引擎的无头命令行工具用于把 HTML 转 PDF不需要任何显示界面。本文覆盖安装、单页转换、页面参数、页眉页脚和批量处理看完可以直接跑通并自行处理常见报错。项目速览wkhtmltopdf 用 QT Webkit 引擎把 HTML 渲染成 PDF配套的wkhtmltoimage还能输出图片全程 headless 运行。功能边界支持 HTML/CSS、页眉页脚、目录和 PDF 书签底层是 2016 年前后的 Webkit依赖非常新的 CSS 特性的页面可能渲染不一致。适合固定版式的报表、文档转换、CI 批量出件不适合要求最新浏览器引擎的场景。官方说明README.md最短上手路径从官方发布页下载与你发行版对应的wkhtmltox二进制包对照表见 docs/downloads.md装上后验证直接贴命令就行# Debian/Ubuntu 22.04 示例替换成你发行版的文件名 sudo dpkg -i wkhtmltox_0.12.6.1-2.jammy_amd64.deb sudo apt-get install -f wkhtmltopdf --version # 输出 0.12.6 即安装成功核心操作常见 HTML 转 PDF 场景转换单页wkhtmltopdf input.html output.pdf # 第一个参数是输入最后一个是输出输入也可以是 URLwkhtmltopdf https://example.com output.pdf。自定义页面参数wkhtmltopdf --page-size A4 --orientation Landscape \ --margin-top 15mm --margin-left 12mm \ input.html output.pdf--page-size支持 A3、Letter 等--orientation只有 Portrait 和 Landscape 两个值页边距默认 10mm可用-B -L -R -T短参数分别设置。页眉页脚与页码wkhtmltopdf --header-right Page [page] of [topage] \ --footer-center [date] input.html output.pdf[page]、[topage]是占位符会替换为当前页码和总页数还支持[webpage]、[title]等变量。目录与批量处理wkhtmltopdf toc input.html output.pdf # 根据 h 标签在文档开头插入目录页面较多时把每行一组参数喂给 stdin可以复用同一个进程比循环调用快不少echo a.html a.pdf | wkhtmltopdf --read-args-from-stdin各平台差异点平台差异操作备注Linux (Debian/Ubuntu)安装对应发行版的 wkhtmltox.deb需 fontconfig 等系统依赖包列表见 docs/downloads.mdLinux (RHEL/CentOS/Alma)安装对应发行版的.rpm同 Debian按发行版选包Windows7z 压缩包解压后把目录加入 PATH.exe安装器会自动写入 PATHmacOS双击.pkg安装二进制位于/usr/local/bin无额外依赖排错速查报错关键词/现象原因解决命令或操作wkhtmltopdf: command not found未加入 PATH常见于 7z 解压版把二进制目录加入 PATH或改装.exe安装器Cannot connect to X11 server用了发行版源里未修补的包需要 X 服务器sudo apt-get install xvfb再用xvfb-run wkhtmltopdf ...运行中文显示为方框乱码系统缺少 CJK 字体sudo apt-get install fonts-wqy-zenhei fc-cachedpkg 提示依赖缺失.deb依赖未装齐sudo apt-get install -fJS 内容没渲染出来页面脚本异步加载渲染时机过早追加参数--javascript-delay 1000延伸参考完整命令行参数docs/usage/wkhtmltopdf.txt各平台安装包对照表docs/downloads.md项目状态与 patched Qt 背景docs/status.md如果你需要在 CI 或脚本里批量生成 PDF这套无头 HTML 转 PDF 流程可以直接落进生产环境使用。【免费下载链接】wkhtmltopdfConvert HTML to PDF using Webkit (QtWebKit)项目地址: https://gitcode.com/gh_mirrors/wk/wkhtmltopdf创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

相关推荐

Harmony OS C++实战
Harmony OS C++实战

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

九联UNT402A刷机改造指南:闲置S905L3机顶盒,20分钟变身24小时在线的Armbian服务器
九联UNT402A刷机改造指南:闲置S905L3机顶盒,20分钟变身24小时在线的Armbian服务器

九联UNT402A刷机改造指南:闲置S905L3机顶盒,20分钟变身24小时在线的Armbian服务器 【免费下载链接】amlogic-s9xxx-armbian Supports running Armbian on Amlogic, Allwinner, and Rockchip devices. Support a311d, s922x, s905x3, s905x2, s912, s905d… · 2026/11/2 15:03:31

支持手机端夸克不限速 - 免费永久解析直链~满速下载!!
支持手机端夸克不限速 - 免费永久解析直链~满速下载!!

今天教大家一招能解决夸克网盘限制的在线工具。这个工具也是完全免费使用的。下面让大家看看我用这个工具的下载速度咋样。地址获取:放在这里了,可以直接获取 这个速度还是不错的把。对于平常不怎么下载的用户还是很友好的。下面开始今天的教学 输入我给… · 2026/11/2 15:03:31

VNC 4.0简体汉化版:老系统远程桌面配置与避坑指南
VNC 4.0简体汉化版:老系统远程桌面配置与避坑指南

简介:远程管理工具VNC 4.0简体汉化版面向需要跨设备远程操控的中文用户,包括企业运维人员、IT管理员及有远程办公需求的个人,解决英文界面门槛高、远程桌面配置繁琐的问题。压缩包共12个文件,约980KB,以exe安装程序为核… · 2026/11/2 15:52:20

AI前沿技术日更简报:高效筛选与验证机制解析
AI前沿技术日更简报:高效筛选与验证机制解析

1. 项目概述:AI前沿技术日更简报的价值定位 每天清晨打开邮箱就能获取一份精心筛选的AI技术动态,这可能是2026年最有效率的行业信息获取方式。我们这个"AI前沿技术日更简报"项目,本质上是一个面向技术决策者、研发工程师和科技投资… · 2026/11/2 15:52:20

CTF夺旗赛:网络安全实战训练与技能进阶指南
CTF夺旗赛:网络安全实战训练与技能进阶指南

1. CTF夺旗赛的本质与起源 CTF(Capture The Flag)夺旗赛最早起源于1996年DEF CON黑客大会,最初只是参会者之间的趣味攻防游戏。如今已发展成为全球范围内最主流的信息安全竞赛形式,每年有超过200场官方赛事在不同国家和地区举办。… · 2026/11/2 15:52:20

IE8浏览器集成VLC视频插件:播放RTSP流与本地文件的完整指南
IE8浏览器集成VLC视频插件:播放RTSP流与本地文件的完整指南

简介:这份资源面向需要在网页中嵌入视频播放能力的开发者与运维人员,聚焦IE8、Chrome、Firefox等浏览器下播放多格式视频及流媒体文件的兼容性难题,提供VLC插件集成的完整参考。压缩包共3个文件,包含1个html示例页面、1个doc说明文… · 2026/11/2 15:52:20

GitHub热榜解析:开发者技术趋势与项目评估指南
GitHub热榜解析:开发者技术趋势与项目评估指南

1. GitHub热榜项目解析:开发者必看的每日风向标 2026年3月6日的GitHub日榜刚刚更新,作为全球最大的代码托管平台,GitHub每日热榜就像开发者社区的脉搏,实时反映着技术圈的潮流动向。我每天早上的第一件事就是刷这个榜单&#xff0… · 2026/11/2 15:52:20

哈希表原理、冲突解决与工业级实现优化
哈希表原理、冲突解决与工业级实现优化

1. 哈希表基础概念解析哈希表(Hash Table)是计算机科学中最基础且最重要的数据结构之一。我第一次接触哈希表是在大学的数据结构课上,当时教授用一个图书馆找书的例子来解释这个概念——想象图书馆有100万本书,如果按顺序查找需要… · 2026/11/2 15:51:19

双极步进电机控制实战: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/2 13:10:28

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/2 4:42: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/2 5:17:18

雷达信号调制技术解析:从LFM到伪线性调频原理与应用
雷达信号调制技术解析:从LFM到伪线性调频原理与应用

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

基于MAX14431与TM4C123的工业SPI隔离电路设计全攻略
基于MAX14431与TM4C123的工业SPI隔离电路设计全攻略

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

PLFM_RADAR:相位线性调频雷达信号处理框架
PLFM_RADAR:相位线性调频雷达信号处理框架

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

双极步进电机控制实战: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/2 13:10:28

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/2 4:42: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/2 5:17:18

了解更多?预约专属演示

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

企业微信二维码