bkhtmltopdf 

将网页内容准确、高效地转换为 PDF，是许多业务场景中的刚需——

报表导出、合同生成、文档归档、电子发票……但市面上不少工具存在排版错乱、样式丢失、中文支持差等问题。

bkhtmltopdf 正是为此类问题设计的一款开源解决方案。它使用与 Chrome 相同的 Blink 渲染引擎（通过 Chromium），确保 HTML 页面在转 PDF 时实现像素级还原，尤其适合对格式一致性要求高的生产环境。

项目采用 AGPL 开源协议，代码公开可查，支持 Docker 部署，适用于 Windows、macOS 和 Linux 系统。

核心优势

像素级排版还原

不同于 wkhtmltopdf 使用较旧的 WebKit 引擎，bkhtmltopdf 基于现代 Chromium 渲染核心，能准确处理：

• 复杂 CSS 布局（flex、grid）
• HTML5 语义标签
• JavaScript 动态渲染内容（如图表、延迟加载元素）

输出的 PDF 视觉效果与浏览器中所见几乎一致。

高性能批量处理

支持多线程并发生成，可轻松应对高负载场景：

• 批量导出用户报告
• 自动生成月度账单
• 网站静态化归档

结合队列系统或定时任务，可实现全自动文档流水线。

完整的现代 Web 支持

无需担心兼容性问题：

• ✅ 支持 CJK（中文、日文、韩文）字符集
• ✅ 正确显示 Emoji 👋🚀💯
• ✅ 内嵌图片格式：PNG、JPEG、SVG（含 Base64 编码）
• ✅ 支持响应式设计与媒体查询

特别适合处理包含动态数据和富样式的前端页面。

🛠️ 易于集成

提供简单的 HTTP 接口，只需一次 POST 请求即可完成转换：

POST /convert
Content-Type: application/json

{
  "html": "<h1>Hello World</h1>",
  "header": "页眉",
  "footer": "页脚 - 第 {{page}} 页"
}

返回生成的 PDF 文件流，可直接写入存储或返回给客户端。

非常适合集成到：

• 后台管理系统
• API 服务
• 自动化工作流

本地化运行，数据可控

所有渲染过程均在本地执行，不依赖外部服务，也不上传任何内容。
对于金融、政务、医疗等对数据安全敏感的行业，这一点至关重要。

典型应用场景