首页 / 新闻资讯 / HTML文档如何转换成PDF：专业方法与步骤详解

HTML文档如何转换成PDF：专业方法与步骤详解

发布时间：2026-08-30 作者：许静 阅读量：96

引言

在日常工作或开发中，经常需要将HTML文档或网页保存为PDF格式，以便分享、打印或归档。本文将介绍多种转换方法，从简单的手动操作到自动化编程方案，帮助您高效完成转换。

方法一：使用浏览器内置打印功能

大多数现代浏览器（如Chrome、Edge、Firefox）都支持将网页直接另存为PDF。操作步骤如下：

  1. 在浏览器中打开HTML文件或网页URL。
  2. 按 Ctrl+P (Windows) 或 Cmd+P (Mac) 打开打印对话框。
  3. 在“目标打印机”中选择“另存为PDF”或“Microsoft Print to PDF”。
  4. 调整页面设置（如纸张大小、边距、背景图形等）。
  5. 点击“保存”即可生成PDF文件。

优点：无需安装额外软件，操作简单。
缺点：无法批量处理，样式还原可能不完美（尤其对复杂CSS）。

方法二：使用命令行工具 wkhtmltopdf

wkhtmltopdf 是一个基于 WebKit 的开源工具，可以从命令行将HTML转换为PDF。适用于批量处理或集成到脚本中。

安装：访问 wkhtmltopdf官网 下载对应操作系统的版本并安装。

基本用法：

wkhtmltopdf input.html output.pdf

也可以指定URL：

wkhtmltopdf https://example.com output.pdf

常用选项：

  • --page-size A4：设置页面大小。
  • --margin-top 10mm：设置上边距。
  • --enable-local-file-access：允许访问本地文件（处理本地HTML时需添加）。

示例：wkhtmltopdf --page-size Letter --margin-top 15mm mypage.html mypage.pdf

方法三：使用 Puppeteer（Node.js 库）

Puppeteer 是一个 Node.js 库，提供高级API控制无头Chrome或Chromium，非常适合精确控制PDF输出。

安装：

npm install puppeteer

代码示例：

const puppeteer = require('puppeteer');

(async () => {
  const browser = await puppeteer.launch();
  const page = await browser.newPage();
  await page.goto('file:///path/to/your.html', { waitUntil: 'networkidle0' });
  await page.pdf({
    path: 'output.pdf',
    format: 'A4',
    printBackground: true,
    margin: { top: '10mm', right: '10mm', bottom: '10mm', left: '10mm' }
  });
  await browser.close();
})();

优点：高度可定制，支持JavaScript渲染，适用于单页应用（SPA）。

方法四：使用 Python 库（如 pdfkit、weasyprint）

Python 生态中有多个库可以完成HTML到PDF的转换。

pdfkit（基于 wkhtmltopdf）

首先安装 wkhtmltopdf 和 pdfkit：

pip install pdfkit

使用示例：

import pdfkit

pdfkit.from_file('input.html', 'output.pdf')
pdfkit.from_url('https://example.com', 'output.pdf')
pdfkit.from_string('<h1>Hello</h1>', 'output.pdf')

weasyprint（纯Python）

安装：pip install weasyprint

使用：

from weasyprint import HTML

HTML('input.html').write_pdf('output.pdf')

优点：无需额外二进制依赖（weasyprint），但渲染效果可能略逊于wkhtmltopdf。

注意事项

  • CSS兼容性：转换工具对CSS3特性的支持程度不同，建议在目标工具下测试。
  • 字体嵌入：确保PDF中使用的字体已嵌入，避免在不同设备上显示差异。
  • 超链接与书签：部分工具支持保留超链接和生成书签（通过HTML标题标签）。
  • 安全性：使用本地文件访问时注意路径安全。

总结

根据需求选择合适的方法：临时操作用浏览器；批量或自动化推荐 wkhtmltopdf 或 Puppeteer；Python 项目可集成 pdfkit 或 weasyprint。掌握这些技巧，您就能轻松应对HTML转PDF的各种场景。

相关文章