
执行 HTML 到 PDF 的转换使用 Node.js SDK。
将 HTML 文件或网页转换为 PDF 对于生成可打印文档、保留布局以及以便携格式归档内容至关重要。使用 GroupDocs.Conversion Cloud SDK for Node.js,您可以通过 REST API 自动化此过程,无需任何第三方工具或浏览器依赖。
在本篇文章中,你将学习如何:
🌐 HTML 转 PDF 转换 API 用于 Node.js
GroupDocs.Conversion Cloud SDK for Node.js 使从 HTML 转换为 PDF 格式的高质量、可扩展转换成为可能,同时保持设计、布局和嵌入媒体。
📦 安装 SDK
使用 npm 进行安装:
npm install groupdocs-conversion-cloud --save
确保您拥有来自 GroupDocs Cloud Dashboard 的个性化客户端 ID 和客户端密钥。有关更多详细信息,您可以考虑访问此 tutorial。
🚀 将 HTML 转换为 PDF 使用 Node.js
以下是使用 Node.js 将 PDF 文档转换为 HTML 的逐步指南:
📌 第一步:导入 SDK 并配置 API:
const { Configuration, ConvertApi, FileApi, UploadFileRequest, ConvertSettings, ConvertDocumentRequest } = require("groupdocs-conversion-cloud");
const config = new Configuration("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");
const convertApi = new ConvertApi(config);
const fileApi = new FileApi(config);
📌 第 2 步:将输入的 HTML 文件上传到云存储:
const fs = require("fs");
const uploadRequest = new UploadFileRequest("input.html", fs.createReadStream("input.html"));
await fileApi.uploadFile(uploadRequest);
📌 第 3 步:设置 HTML 转 PDF 的转换选项:
const settings = new ConvertSettings();
settings.filePath = "input.html";
settings.format = "pdf";
settings.outputPath = "converted/output.pdf";
const request = new ConvertDocumentRequest(settings);
await convertApi.convertDocument(request);
console.log("✅ The HTML successfully converted to PDF.");
// 更多示例请查看 [https://github.com/groupdocs-conversion-cloud/groupdocs-conversion-cloud-dotnet](https://github.com/groupdocs-conversion-cloud/groupdocs-conversion-cloud-dotnet)
// 获取您的 API 凭据
string clientId = "XXXXXX-XXXXXXXXX-4088-9ca0-55c38f4b7f22";
string clientSecret1 = "XXXXXXXXXXXXXXXXXXXX";
// 创建 Configuration 类的实例,并使用客户端 ID 和客户端密钥初始化它
Configuration configuration = new Configuration(clientId, clientSecret);
// 定义用于在线执行 PDF 转 HTML 转换的 API 基础 URL
configuration.setApiBaseUrl("https://api.groupdocs.cloud");
// 使用 Configuration 对象初始化 ConvertApi 实例
ConvertApi convertApi = new ConvertApi(configuration);
ConvertSettings settings = new ConvertSettings();
settings.setStorageName("internal");
settings.setFilePath("input.html");
settings.setFormat("PDF");
settings.setOutputPath("resultant.pdf");
// 使用 ConvertDocument 方法将 HTML 转换为 PDF 格式
ConvertDocumentRequest request = new ConvertDocumentRequest(settings);
List<StoredConvertedResult> response = convertApi.convertDocument(request);
// 检查响应并打印成功消息
if (response != null && response.equals("OK")) {
System.out.println("The HTML file is successfully converted PDF! The Resultant PDF file is saved at: " + response.getFilePath());
}

Image:- A preview of HTML to PDF conversion.
下载上面示例中生成的示例 PDF 文件,来自 resultant.pdf。
💻 使用 cURL 将 HTML 转换为 PDF
你更喜欢 CLI 吗?你也可以使用 cURL 通过 GroupDocs.Conversion Cloud API 端点将 HTML 转换为 PDF。
- ✅ 这种方法非常适合自动化管道和基于脚本的转换。
步骤 1:获取 JWT 访问令牌
curl -v "https://api.groupdocs.cloud/connect/token" \
-X POST \
-d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET" \
-H "Content-Type: application/x-www-form-urlencoded"
第 2 步:将 HTML 转换为 PDF
curl -v "https://api.groupdocs.cloud/v2.0/conversion" \
-X POST \
-H "accept: application/json" \
-H "authorization: Bearer {accessToken}" \
-H "Content-Type: application/json" \
-d "{ \"StorageName\": \"default\", \"FilePath\": \"{sourcePDF}\", \"Format\": \"html\", \"OutputPath\": \"{finalOutput}\"}"
替换 sourceFile, resultantFile 和 accessToken 为实际值。
- 现在为了将 PDF 保存到本地驱动器,您可以考虑使用以下 cURL 命令:
curl -v "https://api.groupdocs.cloud/v2.0/conversion" \
-X POST \
-H "accept: application/json" \
-H "authorization: Bearer {accessToken}" \
-H "Content-Type: application/json" \
-d "{ \"StorageName\": \"default\", \"FilePath\": \"{sourceFile}\", \"Format\": \"html\"}" \
-o "myOutput.html"
🧪 尝试免费的在线 HTML 转 PDF 转换器
想要快速的无代码解决方案吗?使用 HTML to PDF Converter 立即转换网页内容。

✅ 结论
使用 GroupDocs.Conversion Cloud SDK for Node.js,您可以快速可靠地将 HTML 转换为 PDF——非常适合构建文档自动化功能或将样式化的 HTML 内容导出为 PDF 的开发人员。
无论您是在 Node.js 后端嵌入此内容还是通过 cURL 使用它,这个 API 提供了灵活性和控制。
🔗 有用的资源
📚 推荐文章
我们建议您探索以下文章: