HTML 转 PDF 转换

使用 Puppeteer 将 HTML 文件和网页转换为专业的 PDF 文档。

快速开始

命令行使用

bash
node scripts/html-to-pdf.js input.html output.pdf
node scripts/html-to-pdf.js input.html output.pdf A4
node scripts/html-to-pdf.js https://example.com output.pdf A4

编程方式使用

javascript
const convertHtmlToPdf = require(./scripts/html-to-pdf.js);

// 简单转换
await convertHtmlToPdf(input.html, output.pdf);

// 带选项
await convertHtmlToPdf(input.html, output.pdf, {
format: Letter,
landscape: true,
margin: { top: 20mm, bottom: 20mm }
});

功能特性

• - ✅ 转换本地 HTML 文件
• ✅ 转换网页 URL（http/https）
• ✅ 可自定义页面格式（A4、Letter 等）
• ✅ 自定义边距和间距
• ✅ 横向/纵向模式
• ✅ 打印背景
• ✅ 页眉和页脚
• ✅ 页面范围
• ✅ 缩放比例

常用选项

选项	类型	默认值	说明
format	string	A4	A4、Letter、A3、A5 等
landscape

boolean | false | 横向方向 | | margin | object | 全部 10mm | { top, right, bottom, left } | | scale | number | 1 | 0.1 到 2.0 | | printBackground | boolean | true | 包含背景颜色 | | displayHeaderFooter | boolean | false | 显示页眉/页脚 |

高级用法

带页眉和页脚

javascript
await convertHtmlToPdf(page.html, output.pdf, {
displayHeaderFooter: true,
headerTemplate:

,
footerTemplate: ,
margin: { top: 40px, bottom: 40px }
});

指定页面范围

javascript
await convertHtmlToPdf(document.html, pages-1-5.pdf, {
pageRanges: 1-5
});

安装

需要 Node.js 和 npm：

bash
npm install puppeteer

参考

有关完整的 API 文档和所有可用选项，请参阅 api.md。