GroupDocs.Editor for .NET を使用した DOCX から HTML への変換 – ガイド

今日の急速に変化するビジネス環境では、Word ドキュメントをクリーンな Web 対応 HTML に変換することが頻繁に求められます。Convert DOCX to HTML を GroupDocs.Editor for .NET で迅速かつ確実に行うことができます。このライブラリは Microsoft Word をインストールせずにドキュメントの編集と変換を可能にします。このチュートリアルでは、SDK の設定から HTML の抽出、編集オプションのカスタマイズ、スプレッドシートの処理まで、全プロセスを順に解説し、ドキュメントワークフローを自信を持って自動化できるようにします。

クイック回答

  • GroupDocs.Editor は DOCX を HTML に変換できますか？ はい、スタイルを保持しながら DOCX を HTML にレンダリングするワンステップ API を提供します。
  • Microsoft Office をインストールする必要がありますか？ いいえ、ライブラリは完全にオフラインで動作します。
  • サポートされている .NET バージョンはどれですか？ .NET Framework 4.5+、.NET Core 3.1+、.NET 5/6/7。
  • 対応しているドキュメント形式は何種類ですか？ DOCX、XLSX、PPTX、PDF、HTML などを含む、30 種類以上の入力・出力形式に対応しています。
  • 本番環境でライセンスが必要ですか？ 試用用の一時ライセンスは無料です。商用利用にはフルライセンスが必要です。

“convert DOCX to HTML” とは何ですか？

DOCX から HTML への変換とは、Microsoft Word ファイルを取得し、ドキュメントの構造、スタイル、画像、テーブル、その他の要素を再現した HTML 文字列を生成することです。生成されたマークアップはブラウザで表示したり、ウェブページに埋め込んだり、下流システムでさらに処理したりでき、デスクトップドキュメントとウェブコンテンツのシームレスな橋渡しを提供します。

DOCX を HTML に変換するために GroupDocs.Editor for .NET を使用する理由は？

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 ファイルをディスクに書き出すこともできます。この簡潔な 2 ステップのプロセスは、テーブル、画像、ヘッダー、フッター、カスタムフォントを自動的に処理し、Microsoft Word を必要とせずに Web 対応の出力を提供します。

手順実装

  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();

デフォルトオプションでワードプロセッシングドキュメントを編集するには？

Editor を DOCX ファイルで初期化した後、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();

スプレッドシートの2番目のタブを編集して HTML としてエクスポートする方法は？

Editor を Excel ファイルで初期化し、SpreadsheetEditOptions インスタンスの SheetIndex を 1 に設定して2番目のシートを選択します。セルの値更新、スタイル適用、行の挿入など必要な編集を行い、最後に SaveOptions.Html を使用して Save を呼び出すと、そのタブの変更を反映した HTML ファイルが生成されます。

手順実装

  1. Editor の初期化 – Excel ファイルをロードします。

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

  2. 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() メソッドは、<head> メタデータ、<style> 定義、元のファイルのレイアウトを反映した <body> コンテンツを含む完全な HTML ドキュメント文字列を返します。この文字列を使用してドキュメントをウェブページに直接埋め込んだり、後で取得するために保存したり、他のサービスに渡してさらに処理したりできます。

手順実装

  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 テーブルとしてダッシュボードに公開する。
  • 共同編集プラットフォーム – ユーザーがウェブ UI で 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 のファイルを処理できます。より大きなファイルは分割するかストリーミングしてください。

結論

convert DOCX to HTML ワークフローを習得することで、GroupDocs.Editor for .NET を使用して、Word および Excel ドキュメントをライセンスフリーでウェブ対応コンテンツに変換する強力な手段が得られます。デフォルト変換、細かく調整した HTML 出力、スプレッドシートのプログラム的編集など、ライブラリの豊富な API がすべてのシナリオをカバーします。これらの手法を自動化パイプラインに組み込むことで、生産性を向上させ、Microsoft Office への依存を減らし、すべてのプラットフォームで一貫した高品質な HTML を提供できます。

最終更新日: 2026-05-17
テスト環境: GroupDocs.Editor 23.9 for .NET
作者: GroupDocs

関連チュートリアル