如何在 Node.js 中创建 PDF 文件

如何安装 IronPDF for Node.js?

使用npm安装@ironsoftware/ironpdf包。 该包兼容Node.js 12.0或更高版本，并支持ESM和CommonJS模块格式。

//:path=/static-assets/pdf/content-code-examples/tutorials/nodejs-create-pdf/install.sh
npm install @ironsoftware/ironpdf

//:path=/static-assets/pdf/content-code-examples/tutorials/nodejs-create-pdf/install.sh
npm install @ironsoftware/ironpdf

IronPDF for Node.js依赖于IronPDF引擎二进制文件，该文件负责底层的基于Chromium的渲染。 引擎在首次运行时自动下载，但您可以预先安装特定平台的包以避免运行时下载。 这在受限网络环境或基于Docker的CI管道中非常有用：

如何在Node.js中从HTML创建PDF？

使用PdfDocument.fromHtml()从HTML字符串生成PDF。 该方法接受任何有效的HTML，包含内联<style>块，通过CDN加载的外部字体，以及类似CSS Grid或Flexbox的布局系统。 Chromium渲染器在生成PDF之前解析所有资源。

:path=/static-assets/pdf/content-code-examples/tutorials/nodejs-create-pdf/html-string-to-pdf.js

PdfDocument实例。 调用.then()处理程序。 Chromium引擎在捕获输出之前处理字体加载、外部样式表和资产解析。 更多模式，请参阅HTML字符串到PDF示例。

:path=/static-assets/pdf/content-code-examples/tutorials/nodejs-create-pdf/html-file-to-pdf.js

如何从URL生成PDF？

使用PdfDocument.fromUrl()将实时网页渲染为PDF。 渲染器加载页面作为完整的浏览器会话，执行JavaScript，应用CSS，等待动态内容后再捕获输出。

:path=/static-assets/pdf/content-code-examples/tutorials/nodejs-create-pdf/url-to-pdf.js

对于通过JavaScript异步加载内容的页面，将其与renderDelay选项（以毫秒为单位）结合使用，以允许在捕获之前增加额外时间。 URL到PDF示例展示了延迟配置和身份验证头。

---

我最喜欢的这种库是 IronPDF。它允许快速高效地操作 PDF 文件。它还具有许多有价值的功能，比如导出为 PDF/A 格式和数字签名 PDF 文档。

Milan Jovanovic

微软MVP

查看案例研究

IronOCR 意味着我们每年可以节省 $40,000 的人工处理成本，同时提高生产力，并释放资源用于高影响任务。我强烈推荐它。

Brent Matzelle

首席技术官，OPYN

查看案例研究

Iron Suite 在我们的运营中起着至关重要的作用。这些工具提高了业务各方面的效率，包括创建平面图和改善库存管理。

David Jones

首席软件工程师，Agorus Build

查看案例研究

如何配置PDF输出设置？

将配置对象作为第二个参数传递给PdfDocument.fromUrl()。 配置对象接受纸张大小、页边距、方向和渲染选项。

:path=/static-assets/pdf/content-code-examples/tutorials/nodejs-create-pdf/pdf-settings.js

关键配置选项包括：

• PdfPaperSize枚举值（A4，Letter，Legal和自定义尺寸）
• landscape: 为横向页面方向设置true
• printBackground: 包含CSS背景颜色和图像
• marginTop/Bottom/Left/Right: 以毫米为单位的页面边距
• renderDelay: 为JavaScript繁重的页面在捕获之前等待的毫秒数

:path=/static-assets/pdf/content-code-examples/tutorials/nodejs-create-pdf/headers-footers.js

如何向PDF添加安全性和元数据？

使用PdfDocument安全方法对生成的PDF应用密码保护和加密。 该库支持所有者和用户密码，提供打印、复制和编辑的细粒度权限控制。

:path=/static-assets/pdf/content-code-examples/tutorials/nodejs-create-pdf/security.js

加密和解密在应用密码时默认使用AES 256位加密。 对于文档认证工作流，IronPDF还支持使用X.509证书的数字签名。

如何合并和操作现有的PDF？

PdfDocument提供合并、拆分和修改现有PDF文件的方法。 使用PdfDocument.fromFile()加载现有PDF，并使用操作方法来添加或删除页面、印章内容或替换文本。

:path=/static-assets/pdf/content-code-examples/tutorials/nodejs-create-pdf/merge-pdfs.js

PdfDocument实例数组，并返回一个合并后的文档。 页面顺序遵循数组顺序，因此输出保留输入文件的顺序。

其他常见的操作操作：

• 使用removePages()从PDF中删除页面
• 在现有文档上盖章HTML内容
• 跨所有页面查找和替换文本
• 从PDF提取文本用于索引或处理

对于高量使用场景，多线程PDF生成可让您并行处理多个文档。 PDF压缩降低文件存储和传输的大小。

如何为复杂内容(如图表和Angular页面)生成PDF？

IronPDF使用完整的Chromium浏览器会话渲染页面，这意味着生成图表、图形或数据可视化的JavaScript库正确渲染，包括JavaScript图表库。 使用像Angular这样的框架构建的单页应用程序也可以通过Angular到PDF示例进行干净转换。

对于包含大量Unicode或多语言输出的文档，IronPDF处理Unicode和国际字符集而无需额外配置。 Google Fonts集成示例展示了如何在渲染的HTML中加载网页字体，以在输出PDF中保持一致的排版。

在Node.js中生成PDF的下一步是什么？

本指南涵盖了IronPDF的核心工作流程：安装库，从HTML字符串、文件和URL生成PDF，配置输出设置，添加页眉和页脚，应用安全策略以及操作现有PDF。

要继续，请尝试完整的HTML到PDF教程以深入了解呈现选项，或浏览API参考以获取完整的PdfDocument方法和配置属性列表。

开始免费试用以生成无水印的PDF，或查看许可选项以进行生产部署。