如何在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

Microsoft MVP

查看案例研究

IronOCR意味著我們每年可以從手動處理中節省$40,000，同時提高生產力，釋放資源以進行高影響的任務。我會強烈推薦它。

Brent Matzelle

首席技術官，OPYN

查看案例研究

IronSuite在我們的運營中扮演著至關重要的角色。這些工具增加了包括建立平面圖和改善庫存管理在內的業務效率。

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壓縮可減少檔案大小以進行儲存和傳輸。

如何為複雜內容生成PDF，如圖表和Angular頁面？

IronPDF使用完全Chromium瀏覽器會話渲染頁面，這意味著生成圖表、圖表或資料視覺化的JavaScript庫正確渲染，包括JavaScript圖表庫。 使用像Angular這樣的框架構建的單頁應用程式也可以使用Angular轉PDF範例乾淨轉換。

對於Unicode密集型文件或多語言輸出，IronPDF處理Unicode和國際字元集無需額外配置。 Google字型整合範例顯示如何在渲染的HTML中載入網頁字形，以確保輸出PDF的字型一致性。

Node.js中建立PDF的下一步是什麼？

本指南涵蓋了IronPDF的核心工作流程：安裝程式庫、從HTML字串、檔案和URL生成PDF、配置輸出設置、新增頁眉和頁腳、應用安全措施以及操作現有PDF。

繼續了解完整的HTML到PDF教學以更深入了解渲染選項，或瀏覽API參考以獲得完整的PdfDocument方法和配置屬性列表。

開始您的免費試用以生成無浮水印的PDF，或查看授權選項以進行生產部署。