將 PDF 文件轉換為 HTML 格式是相當必要的,特別是當我們需要在線顯示內容時,這樣可以提高可獲取性,並使內容在 Web 應用程序中易於重用。在這篇文章中,您將學習如何使用 GroupDocs.Conversion Cloud SDK for .NET 將 PDF 轉換為 HTML,同時保留文檔佈局、圖像和格式。
這篇文章涵蓋以下主題:
PDF to HTML 轉換 API
GroupDocs.Conversion Cloud SDK for .NET 提供了一個強大的 API,可高精度地將 PDF 文件轉換為 HTML。它允許您自定義輸出的 HTML,定義頁面範圍並控制圖像質量,使其非常適合在您的 .NET 應用程序中集成文檔到網頁的工作流程。
安裝
透過 NuGet 套件管理器安裝 SDK:
Install-Package GroupDocs.Conversion-Cloud -Version 24.2.0
或使用 .NET CLI:
dotnet add package GroupDocs.Conversion-Cloud --version 24.2.0
現在,您需要從 Aspose Cloud Dashboard 獲取您的個人化客戶端 ID 和客戶端密鑰,以驗證 API 請求。
將 PDF 轉換為 HTML 在 C# (.NET) 中
這是一個逐步的 C# 示例,用於將 PDF 轉換為 HTML:
- 配置 API 憑證:
var config = new Configuration
{
ClientId = "YOUR_CLIENT_ID",
ClientSecret = "YOUR_CLIENT_SECRET"
};
var convertApi = new ConvertApi(config);
var fileApi = new FileApi(config);
- 上傳 PDF 文件到雲端儲存:
using (var fileStream = File.OpenRead("sample.pdf"))
{
var uploadRequest = new UploadFileRequest("sample.pdf", fileStream);
fileApi.UploadFile(uploadRequest);
}
- 設定轉換設置:
var settings = new ConvertSettings
{
FilePath = "sample.pdf",
Format = "html",
OutputPath = "converted/resultant.html"
};
- 執行 PDF 到 HTML 轉換:
var request = new ConvertDocumentRequest(settings);
convertApi.ConvertDocument(request);
using System;
using GroupDocs.Conversion.Cloud.Sdk.Api;
using GroupDocs.Conversion.Cloud.Sdk.Client;
using GroupDocs.Conversion.Cloud.Sdk.Model.Requests;
using System.IO;
using GroupDocs.Conversion.Cloud.Sdk.Model;
namespace GroupDocs.Conversion.CSharp
{
// 執行 PDF 轉 HTML 轉換
class PDFConversion
{
static void Main(string[] args)
{
try
{
// 獲取您的 API 憑證
string clientId = "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx";
string clientSecret = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx";
string myStorage = "test";
// 實例化 Configuration 類別的一個實例,並提供 Client Secret 和 Client ID。
var configuration = new Configuration(clientId, clientSecret);
// 定義 ApiBaseUrl 的值以設置 API 的基本 URL。
configuration.ApiBaseUrl = "https://api.groupdocs.cloud";
// 使用 Configuration 類的物件初始化 ConvertApi 類的物件。
var apiInstance = new ConvertApi(configuration);
// 創建 ConvertSettings 類的實例。
var settings = new ConvertSettings
{
FilePath = "sample.pdf",
Format = "html",
OutputPath = "converted/resultant.html"
};
// 呼叫 API 以觸發 PDF 到網頁的轉換。
var response = apiInstance.ConvertDocument(new ConvertDocumentRequest(settings));
Console.WriteLine("Successfully converted the PDF file to HTML format in C#: " + response[0].Url);
}
catch (Exception e)
{
Console.WriteLine("Exception when calling GroupDocs Api: " + e.Message);
}
}
}
}

Image:- A preview of PDF to HTML conversion.
- 在上面的範例中使用的樣本 PDF 可以從 input.pdf 下載。
使用 cURL 將 PDF 轉換為網頁
您也可以使用 GroupDocs.Conversion Cloud REST API 與 cURL 進行快速命令行轉換。
- 使用您的憑證生成 JWT 訪問令牌。
- Run the following cURL command:
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\": \"{resultantFile}\"}"
- 執行以下命令以將 HTML 儲存到本地磁碟:
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 "{resultantFile}"
- 替換:
sourceFile
,resultantFile
,和accessToken
為實際值。
試試我們的免費 PDF 轉 HTML 轉換器
嘗試我們的免費 PDF to HTML Converter 應用程式,以在將其整合到您的應用程式之前查看轉換質量。

有用的連結
結論
使用 GroupDocs.Conversion Cloud SDK for .NET,您可以輕鬆地將 PDF 轉換成 HTML,集成到您的 .NET 項目中,實現高品質、網頁相容的輸出,同時保留格式。無論您是使用 C# 中的 SDK,還是通過 cURL 直接調用 REST API,該過程都是直觀且高度可定制的。
推薦文章
我們強烈建議您探索以下文章: