使用 GroupDocs.Editor for .NET 轉換 DOCX 為 HTML – 指南

在當今快速變化的商業環境中，將 Word 文件轉換為乾淨、可直接在網頁上使用的 HTML 是常見需求。使用 GroupDocs.Editor for .NET，快速且可靠地 Convert DOCX to HTML，此函式庫允許您在未安裝 Microsoft Word 的情況下編輯和轉換文件。本教學將帶您完成整個流程——從設定 SDK、提取 HTML、客製化編輯選項，到處理試算表——讓您能自信地自動化文件工作流程。

快速解答

  • GroupDocs.Editor 能將 DOCX 轉換為 HTML 嗎？ 是的，它提供一步式 API，將 DOCX 轉換為 HTML 並保留樣式。
  • 需要安裝 Microsoft Office 嗎？ 不需要，該函式庫完全離線運作。
  • 支援哪些 .NET 版本？ .NET Framework 4.5+、.NET Core 3.1+、.NET 5/6/7。
  • 可處理多少種文件格式？ 超過 30 種輸入與輸出格式，包括 DOCX、XLSX、PPTX、PDF 與 HTML。
  • 生產環境需要授權嗎？ 臨時試用授權免費；商業使用則需正式授權。

什麼是「convert DOCX to HTML」？

將 DOCX 轉換為 HTML 意味著將 Microsoft Word 檔案產生為一段 HTML 字串，重現文件的結構、樣式、圖像、表格及其他元素。產生的標記可在瀏覽器中顯示、嵌入網頁，或供下游系統進一步處理，提供桌面文件與網路內容之間的無縫橋樑。

為什麼使用 GroupDocs.Editor for .NET 轉換 DOCX 為 HTML？

GroupDocs.Editor 可處理 50+ 種文件類型，且能在不將整個檔案載入記憶體的情況下處理高達 200 MB 的檔案，在一般伺服器上可達 每 100 頁 DOCX 最多 3 秒 的轉換速度。其離線特性消除 Microsoft Office 的授權成本，並降低與外部相依性相關的安全風險。

前置條件

  • 必需的函式庫：透過您偏好的套件管理員安裝 GroupDocs.Editor for .NET。
  • 開發環境：Visual Studio 2022 或任何相容 .NET 的 IDE。
  • 知識基礎：熟悉 C# 與基本文件概念有助於開發，但非必須。

設定 GroupDocs.Editor for .NET

安裝說明

.NET CLI:

dotnet add package GroupDocs.Editor

Package Manager:

Install-Package GroupDocs.Editor

NuGet 套件管理員 UI:
搜尋 “GroupDocs.Editor” 並安裝最新版本。

取得授權

先使用免費試用版評估 GroupDocs.Editor。若需長期使用，可考慮取得臨時授權或購買訂閱。前往 GroupDocs Purchase 了解取得授權的詳細資訊。

基本初始化

Editor 類別是 GroupDocs.Editor 中所有文件操作的入口點。它代表載入記憶體的單一文件，並提供編輯與轉換的方法。

using GroupDocs.Editor;
using GroupDocs.Editor.Options;

Editor editor = new Editor("YOUR_DOCUMENT_DIRECTORY/SAMPLE_DOCX", new Options.WordProcessingLoadOptions());

如何使用 GroupDocs.Editor for .NET 將 DOCX 檔案轉換為 HTML？

使用 Editor 建構子載入來源 DOCX，然後呼叫 Save 方法並指定 SaveOptions.Html。此呼叫會回傳完整樣式的 HTML 字串，並可選擇將 HTML 檔寫入磁碟。這個簡潔的兩步驟流程會自動處理表格、圖像、頁首、頁尾與自訂字型，產生可直接使用於網頁的輸出，且不需 Microsoft Word。

步驟實作

  1. 初始化 Editor – 載入您的 DOCX 檔案。

    Editor editor = new Editor("YOUR_DOCUMENT_DIRECTORY/SAMPLE_DOCX", new Options.WordProcessingLoadOptions());

  2. 執行轉換 – 使用 HTML 儲存選項。

    EditableDocument defaultWordProcessingDoc = editor.Edit();
defaultWordProcessingDoc.Dispose();
editor.Dispose();

如何使用預設選項編輯文字處理文件？

在使用您的 DOCX 檔案初始化 Editor 後，您可以直接呼叫 InsertText、ReplaceText 或 DeleteParagraph 等方法，無需提供額外的設定物件。函式庫會使用內建的預設設定套用這些變更，保留原有的格式與版面配置，非常適合快速內容更新或簡單修訂。

步驟實作

  1. 初始化 Editor – 載入您的文件。

    Editor editor = new Editor("YOUR_DOCUMENT_DIRECTORY/SAMPLE_DOCX", new Options.WordProcessingLoadOptions());

  2. 使用預設選項編輯 – 直接套用變更。

    WordProcessingEditOptions wordProcessingEditOptions = new WordProcessingEditOptions();
wordProcessingEditOptions.EnablePagination = false;
wordProcessingEditOptions.EnableLanguageInformation = true;
wordProcessingEditOptions.FontExtraction = FontExtractionOptions.ExtractAllEmbedded;

EditableDocument customOptionDoc = editor.Edit(wordProcessingEditOptions);
customOptionDoc.Dispose();
editor.Dispose();

自訂編輯選項如何提升 DOCX 轉換為 HTML 的效果？

自訂編輯選項讓您對轉換輸出擁有精細的控制。透過調整 Pagination、EmbedFonts、EmbedImages 等屬性，您可以決定 HTML 是否分頁、是否包含 Base64 編碼的圖像，或直接嵌入字型檔案。這些設定協助您根據特定的網頁設計或效能需求調整標記。

步驟實作

  1. 初始化 Editor – 載入您的文件。

    Editor editor = new Editor("YOUR_DOCUMENT_DIRECTORY/SAMPLE_DOCX", new Options.WordProcessingLoadOptions());

  2. 設定自訂選項 – 設定符合您發布需求的屬性。

    WordProcessingEditOptions wordProcessingEditOptions = new WordProcessingEditOptions(true);
wordProcessingEditOptions.FontExtraction = FontExtractionOptions.ExtractAll;

EditableDocument anotherCustomOptionDoc = editor.Edit(wordProcessingEditOptions);
anotherCustomOptionDoc.Dispose();
editor.Dispose();

如何編輯試算表的第一個工作表並匯出為 HTML？

使用 Editor 類別載入 Excel 活頁簿，然後建立 SpreadsheetEditOptions 物件，將其 SheetIndex 屬性設為 0，以鎖定第一個工作表。完成所需的儲存格或格式變更後，呼叫 Save 並使用 SaveOptions.Html，即可產生該工作表的 HTML 表示，保留公式與樣式。

步驟實作

  1. 初始化 Editor – 載入 Excel 檔案。

    Editor editor = new Editor("YOUR_DOCUMENT_DIRECTORY/SAMPLE_XLSX", new SpreadsheetLoadOptions());

  2. 編輯第一個工作表 – 套用所需變更並匯出。

    SpreadsheetEditOptions sheetTab1EditOptions = new SpreadsheetEditOptions();
sheetTab1EditOptions.WorksheetIndex = 0; // Selects the first tab (index is 0-based).

EditableDocument firstTabDoc = editor.Edit(sheetTab1EditOptions);
firstTabDoc.Dispose();
editor.Dispose();

如何編輯試算表的第二個工作表並匯出為 HTML？

使用 Excel 檔案初始化 Editor，然後設定 SpreadsheetEditOptions 實例的 SheetIndex 為 1，以選取第二個工作表。執行所需的編輯——例如更新儲存格值、套用樣式或插入列——最後使用 SaveOptions.Html 呼叫 Save，產生反映該工作表變更的 HTML 檔案。

步驟實作

  1. 初始化 Editor – 載入 Excel 檔案。

    Editor editor = new Editor("YOUR_DOCUMENT_DIRECTORY/SAMPLE_XLSX", new SpreadsheetLoadOptions());

  2. 編輯第二個工作表 – 修改儲存格、公式或格式，然後匯出。

    SpreadsheetEditOptions sheetTab2EditOptions = new SpreadsheetEditOptions();
sheetTab2EditOptions.WorksheetIndex = 1; // Selects the second tab (index is 0-based).

EditableDocument secondTabDoc = editor.Edit(sheetTab2EditOptions);
secondTabDoc.Dispose();
editor.Dispose();

如何從可編輯文件中提取 HTML 內容？

Editor 實例的 GetHtml() 方法會回傳完整的 HTML 文件字串，包含 <head> 中的中繼資料、<style> 定義，以及與原始檔案版面相同的 <body> 內容。您可將此字串直接嵌入網頁、儲存以供日後取用，或傳遞給其他服務進一步處理。

步驟實作

  1. 初始化 Editor – 載入您的文件（Word 或 Excel）。

    Editor editor = new Editor("YOUR_DOCUMENT_DIRECTORY/SAMPLE_XLSX", new SpreadsheetLoadOptions());

  2. 提取 HTML 內容 – 呼叫 editor.GetHtml() 並使用其結果。

    SpreadsheetEditOptions sheetTab1EditOptions = new SpreadsheetEditOptions();
sheetTab1EditOptions.WorksheetIndex = 0;

EditableDocument editableDoc = editor.Edit(sheetTab1EditOptions);
string bodyContent = editableDoc.GetBodyContent(); // HTML within the BODY element.
string allContent = editableDoc.GetContent(); // Full HTML markup including HEAD.

List<IImageResource> images = editableDoc.Images;
List<IHtmlResource> resources = editableDoc.AllResources;

editableDoc.Dispose();
editor.Dispose();

實務應用

  • 自動化文件工作流程 – 將收到的 DOCX 檔案轉換為 HTML，供 CMS 匯入，免除手動步驟。
  • 動態報表 – 程式化編輯 Excel 工作表，然後將結果以 HTML 表格發布於儀表板。
  • 協作編輯平台 – 允許使用者在網頁介面編輯 Word 文件，然後將最終的 HTML 版本儲存作為歸檔。

效能考量

  • 記憶體管理：及時釋放 Editor 實例以釋放非受控資源。
  • 大型檔案：對於超過 100 MB 的文件，啟用串流模式 (options.UseStreaming = true) 以將記憶體佔用維持在 200 MB 以下。
  • 批次處理：在迴圈中轉換多個檔案時，重複使用同一個 Editor 實例以降低開銷。

常見問題與解決方案

  • HTML 中缺少圖像：確保 options.EmbedImages = true，使圖像轉換為 Base64 並直接嵌入。
  • 字型渲染不正確：啟用 options.EmbedFonts = true，將自訂字型包含於 HTML 中。
  • 找不到工作表：確認零基礎的 SheetIndex 與目標工作表相符；可使用 editor.GetWorksheets() 列出可用工作表。

常見問答

Q: 我可以將受密碼保護的 DOCX 檔案轉換為 HTML 嗎？
A: 可以。於初始化 Editor 實例時提供密碼，函式庫會在轉換前解密檔案。

Q: GroupDocs.Editor 是否支援將 DOCX 轉換為其他網頁格式，例如 Markdown？
A: 目前主要輸出為 HTML，但您可使用第三方轉換器將 HTML 後處理為 Markdown。

Q: 函式庫如何處理 Word 的複雜功能，例如註腳或尾註？
A: 註腳與尾註會以上標連結的形式呈現在產生的 HTML 中，保留其參考關係。

Q: 是否可以只將 DOCX 的特定章節轉換為 HTML？
A: 可以。使用 DocumentPart 取得目標章節，然後對該部分呼叫帶有 HTML 選項的 Save。

Q: 轉換支援的最大檔案大小是多少？
A: GroupDocs.Editor 可在單次請求中處理最高 200 MB 的檔案；較大的檔案應拆分或使用串流方式。

結論

透過熟悉 GroupDocs.Editor for .NET 的 convert DOCX to HTML 工作流程，您即可獲得一套強大且免授權的解決方案，將 Word 與 Excel 文件轉換為可直接使用於網頁的內容。無論是需要預設轉換、精細調整的 HTML 輸出，或是程式化編輯試算表，函式庫的完整 API 都能滿足各種情境。將這些技術整合至自動化流程，可提升生產力、減少對 Microsoft Office 的依賴，並在所有平台上提供一致且高品質的 HTML。

最後更新： 2026-05-17
測試環境： GroupDocs.Editor 23.9 for .NET
作者： GroupDocs

相關教學