推荐使用node-html-pdf：HTML到PDF的转换利器

2026-01-16 10:06:43作者：董宙帆

项目介绍

node-html-pdf 是一个基于 phantomjs 的HTML到PDF转换工具，它能够将HTML文档转换为高质量的PDF文件。这个开源项目不仅提供了命令行工具，还提供了丰富的API接口，使得开发者可以轻松地在Node.js环境中集成和使用。

项目技术分析

node-html-pdf 的核心技术是利用 phantomjs 来渲染HTML页面并生成PDF。phantomjs 是一个无头浏览器，能够模拟浏览器环境执行JavaScript，从而实现HTML页面的渲染。node-html-pdf 在此基础上提供了简洁的API和命令行工具，使得转换过程更加便捷。

项目及技术应用场景

node-html-pdf 适用于多种场景，包括但不限于：

电子商务：生成订单收据、发票等PDF文档。
内容管理系统：将网页内容导出为PDF格式，便于存档和分享。
报告生成：自动化生成各类报告，如财务报告、业务报告等。
个人项目：创建个人简历、名片等PDF文档。

项目特点

易于使用：提供简单的命令行工具和API接口，方便集成到现有项目中。
高度可定制：支持自定义页面大小、边距、页眉页脚等，满足各种打印需求。
灵活的页眉页脚：可以根据页面编号动态设置页眉页脚内容。
支持多种输出格式：除了PDF，还支持PNG和JPEG格式。
安全性：提供选项限制本地文件访问，增强安全性。

安装与使用

安装

通过npm全局安装：

$ npm install -g html-pdf

命令行示例

$ html-pdf test/businesscard.html businesscard.pdf

代码示例

var fs = require('fs');
var pdf = require('html-pdf');
var html = fs.readFileSync('./test/businesscard.html', 'utf8');
var options = { format: 'Letter' };

pdf.create(html, options).toFile('./businesscard.pdf', function(err, res) {
  if (err) return console.log(err);
  console.log(res); // { filename: '/app/businesscard.pdf' }
});