当前位置：首页 > news >正文

bkhtmltopdf - 高性能 HTML 转 PDF 工具（代替 wkhtmltopdf）

news 2025/10/14 8:12:26

bkhtmltopdf 的名称来源于 Blink HTML to PDF，其中 Blink 是 Chromium 的渲染引擎。

由于 wkhtmltopdf 停止更新（我猜可能是 QtWebKit 的兼容问题），所以我开发了一个 bkhtmltopdf。它基于 Java + CEF 开发，并支持了更多特性，在企业中生成 PDF 报告、账单、报表、医疗单、体检单等场景下非常有用。

功能/特性

极高的性能
采用 Chromium 新版本（135+）
支持 HTML5、CSS3、JavaScript 等高级特性
页眉、页脚、大纲、无障碍 PDF
多语言、多字体（支持CJK、老挝、藏语等少数语言）
高精度保真（生成的 PDF 与 HTML 效果完全一致）
集成条形码（支持QRCode、Code128、Code11等近百种条形码）
集成图表（基于 Apache ECharts ）
支持 Markdown 转 PDF

安装

下载最新版本，下载之后执行（需要 JDK 21及以上）：

java -jar bkhtmltopdf-x.y.z.jar

条形码

如果要使用条形码，只需要一行代码即可实现。

生成的条码基于 SVG 矢量图，所以 PDF 可以无限放大。这样的好处是打印出来的 PDF 文件不会失真、出现毛刺等问题。

<barcode type="qrcode" value="Hi, bkhtmltopdf." width="200px" height="200px"alt="This is a QR code whose value is: Hi, bkhtmltopdf."/><barcode type="code128" value="123456789" width="200px" height="200px" options="includetext"alt="This is a Code 128 whose value is: 123456789"/>

在线运行

图表

如果要使用图表功能，也只需要简单的几行代码。

<chart src="chart-1" width="500" height="500" alt="This is a chart"/><script id="chart-1" type="application/json5">{xAxis:{type:'category',data:['Mon','Tue','Wed','Thu','Fri','Sat','Sun']},yAxis:{type:'value'},series:[{data:[150,230,224,218,135,147,260],type:'line'}]}
</script>

在线运行