在今天的数字环境中，HTML 是在线显示和共享结构化数据最广泛使用的格式之一。然而，在归档、分发或离线访问时，PDF 仍然是首选格式。开发人员通常需要将 HTML 转换为 PDF，以创建报告、发票或以通用兼容格式保存网页内容。

这篇文章涵盖以下主题：

HTML to PDF 转换 SDKs

GroupDocs.Conversion Cloud SDK for .NET 提供了强大且可扩展的文件格式转换解决方案。在使用此 API 的功能时，您可以无缝地将 HTML 转换为 PDF，确保准确性、一致性和卓越的性能——所有这一切无需安装额外的软件。

开始使用 HTML 到 PDF 转换

在开始之前，请确保您具备以下先决条件：

  1. 一个 GroupDocs Cloud account 用于获取您的客户端 ID 和客户端密钥。有关更多信息，请访问简短的 tutorial。
  2. 一个用于测试的 HTML 文件或网页。
  3. 一个配置好的 .NET 开发环境(例如 Visual Studio 或 Rider)。

您可以通过运行以下命令从 NuGet 包管理器安装 SDK：

Install-Package GroupDocs.Conversion-Cloud -Version 25.9.0

将 HTML 转换为 PDF，使用 C#

让我们探索如何使用 C# 和 GroupDocs Cloud SDK 以编程方式执行 HTML 到 PDF 的转换。

  1. 创建 Configuration 类的实例，其中我们将客户端凭据作为参数传递。
var configuration = new Configuration
{
    AppSid = "YOUR_CLIENT_ID",
    AppKey = "YOUR_CLIENT_SECRET"
};
  1. 初始化 ConvertApi 和 FileApi 的实例，并将 Configuration 对象作为参数传递。
var convertApi = new ConvertApi(configuration);
var fileApi = new FileApi(configuration);
  1. 上传输入的 HTML 到云存储。
using (var stream = File.OpenRead("source.html"))
{
    var uploadRequest = new UploadFileRequest("source.html", stream);
    fileApi.UploadFile(uploadRequest);
}
  1. 创建一个 ConvertSettings 的实例，其中我们指定输入 HTML 的名称、输出格式为 pdf 和生成的 PDF 名称。
var settings = new ConvertSettings
{
    FilePath = "index.html",
    Format = "pdf",
    OutputPath = "converted/html-to-pdf-result.pdf"
};
  1. 调用 ConvertDocumentRequest API 将 HTML 转换为 PDF 格式。转换成功后，结果 PDF 存储在云存储中。
var request = new ConvertDocumentRequest(settings);
convertApi.ConvertDocument(request);

一旦请求执行，您的 HTML 文件将被转换为高质量的 PDF 并存储在您云存储中指定的输出文件夹内。

使用 cURL 将 HTML 转换为 PDF

如果您更喜欢通过脚本或自动化管道进行转换，cURL 是一个优秀的替代方案。它允许您直接从命令行执行 REST API 调用，非常适合快速测试和批处理。

为什么使用 cURL 进行 HTML 到 PDF 的转换？

  • 不需要安装 SDK。
  • 适合 shell 脚本、CI/CD 工作流或后台服务。
  • 轻量且易于自动化。

在运行 HTML 到 PDF 转换命令之前，基于客户端凭据生成您的 JWT 访问令牌。令牌生成后，请执行以下命令。

curl -v "https://api.groupdocs.cloud/v2.0/conversion" \
-X POST \
-H "accept: application/json" \
-H "authorization: Bearer {ACCESS_TOKEN}" \
-H "Content-Type: application/json" \
-d "{  \"StorageName\": \"internal\",  \"FilePath\": \"{sourceFile}\",  \"Format\": \"pdf\",  \"LoadOptions\": {    \"Format\": \"html\"  },  \"ConvertOptions\": {    \"FromPage\": 1,    \"PagesCount\": 1,    \"Pages\": [      1    ],    \"WatermarkOptions\": {      \"Text\": \"Confidential\",      \"FontName\": \"Arial\",      \"FontSize\": 12,      \"Bold\": false,      \"Italic\": true,      \"Color\": \"Red\",      \"Width\": 10,      \"Height\": 6,      \"Top\": 100,      \"Left\": 100,      \"RotationAngle\": 10,      \"Transparency\": 0.8,      \"Background\": true,      \"AutoAlign\": true    }  },  \"OutputPath\": \"{converted}\"}"

将 {ACCESSTOKEN} 替换为您生成的 JWT 令牌，并将 index.html 替换为您的 HTML 文件名称。

尝试免费 HTML 到 PDF 转换器

如果你想在不编写任何代码的情况下探索转换过程，可以尝试免费的 HTML to PDF Converter。 由 GroupDocs.Conversion Cloud 提供支持的 Web 应用程序。它允许您上传任何 HTML 文件或 URL，并即时下载生成的 PDF。

html to pdf converter

有用的链接

结论

使用 .NET REST API 将 HTML 转换为 PDF 为开发人员提供了一种可靠的方法来在便携格式中保留网页布局、样式和内容。使用 GroupDocs.Conversion Cloud SDK for .NET，您可以只需几行代码自动化此过程——无论您需要转换单个 HTML 文件还是整个批次的网页。

相关的文章

我们强烈推荐访问以下链接以了解更多信息：

常见问题解答 (FAQs)

  1. 如何在 C# .NET 中将 HTML 转换为 PDF？
  • 您可以使用 GroupDocs.Conversion Cloud SDK for .NET 上传 HTML 文件，配置输出格式为 PDF，并执行 ConvertDocument() 方法以生成已转换的文件。
  1. 此 API 是否支持转换带有 CSS 和图像的 HTML？
  • 是的。SDK 维护所有链接资源，确保您转换后的 PDF 精确保留布局、字体、图像和样式。
  1. 我可以直接从网址转换网页吗？
  • 是的。您可以在输入路径中指定一个网页 URL，API 将呈现 HTML 内容并将其转换为 PDF 文档。
  1. 我需要安装任何第三方工具，例如 Adobe Acrobat 吗？
  • 不。整个过程是基于云的——无需本地安装或额外的软件。