このブログ投稿では、ファイル形式の変換と操作に伴う実際の問題の解決策を説明します。 Doc/Docx を MD に変換する必要があるシナリオは複数ありますが、幸いなことに、GorupDocs.Conversion を使用すると、Docx から Markdown への変換を手動でもプログラムでも実行できます。ただし、Word を Markdown に変換するための Cloud SDK、REST API、および オンライン ツールがあり、それらはすべて GorupDocs.Conversion によって強化されています。さらに、簡単な API 呼び出しを行うことで、独自の Markdown ジェネレーターを構築できます。それでは、GorupDocs.Conversion Cloud SDK for .NET を使用してプログラムで C# の Word を Markdown に変換する方法を見てみましょう。
このガイドでは、次のセクションについて説明します。
マークダウン ジェネレーター ライブラリのインストール
GorupDocs.Conversion Cloud SDK for .NET はインストールが非常に簡単で、そのインストール手順はサードパーティ ソフトウェアに依存しません。この Docx から MD コンバーター ライブラリをインストールするには、この NuGet パッケージ をダウンロードするか、NuGet パッケージ マネージャーで次のコマンドを実行します。
Install-Package GroupDocs.Conversion-Cloud -Version 23.10.0
したがって、次のステップは、API クラウド ダッシュボード から API 認証情報 (クライアント ID + クライアント シークレット) を取得することです。繰り返しますが、これは非常に簡単で、数秒で完了します。 API 認証情報の取得に問題がある場合は、この ガイド に従ってください。
C# で Word をプログラムで Markdown に変換する
これで、.NET アプリケーションで Docx を MD に変換するための数行のコードを書き始めることができます。
注: ソース Doc/Docx ファイルを API クラウド ダッシュボード にアップロードしました。ただし、UploadFile メソッドを呼び出すことにより、手動またはプログラムでアップロードできます。
以下の手順に従ってください。
- クライアント シークレットとクライアント ID を使用して、Configuration クラスのインスタンスをインスタンス化します。
- ApiBaseUrl の値を定義して、API のベース URL を設定します。
- ConvertApi クラスのオブジェクトを Configuration クラスのオブジェクトで初期化します。
- ConvertSettings クラスのインスタンスを作成し、FilePath、Format などの値を設定して初期化します。
- ConvertDocument メソッドを呼び出し、ConvertDocumentRequest クラスのインスタンスを渡して、Docx をプログラム的に MD に変換します。
次のコード スニペットは、プログラムを使用して C# で Word を MD に変換する方法を示しています。
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
{
// C# で Word を Markdown に変換する
class Convert_Docx_to_MD
{
static void Main(string[] args)
{
try
{
// API 認証情報を取得する
string clientId = "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx";
string clientSecret = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx";
string myStorage = "test";
// クライアント シークレットとクライアント ID を使用して、Configuration クラスのインスタンスをインスタンス化します。
var configuration = new Configuration(clientId, clientSecret);
// ApiBaseUrl の値を定義して、API のベース URL を設定します。
configuration.ApiBaseUrl = "https://api.groupdocs.cloud";
// ConvertApi クラスのオブジェクトを Configuration クラスのオブジェクトで初期化します。
var apiInstance = new ConvertApi(configuration);
// ConvertSettings クラスのインスタンスを作成し、FilePath、Format などの値を設定して初期化します。
var settings = new ConvertSettings
{
FilePath = "sample.docx",
Format = "md",
OutputPath = "test/output-sample-file.md"
};
// ConvertDocument メソッドを呼び出し、ConvertDocumentRequest クラスのインスタンスを渡して、Docx をプログラム的に MD に変換します。
var response = apiInstance.ConvertDocument(new ConvertDocumentRequest(settings));
Console.WriteLine("Successfully converted Docx to Markdown in C#: " + response[0].Url);
}
catch (Exception e)
{
Console.WriteLine("Exception when calling GroupDocs Api: " + e.Message);
}
}
}
}
サーバーを実行すると、API クラウド ダッシュボード の「test」フォルダーに新しい MD ファイル (つまり、output-sample-file.md) が生成されるのが表示されます。したがって、DownloadFile メソッドを呼び出して、手動またはプログラムでファイルをダウンロードできます。
Docx をオンラインで Markdown に変換
これまで、プログラムによって Word を C# の Markdown に変換する方法を学習しました。 GorupDocs.Conversion によってサポートされる オンライン Docx から MD へのコンバーターを利用できるようになりました。使いやすく、非常に優れたドラッグ アンド ドロップ UI が付属しています。何よりも、無料で使用でき、どの Web ブラウザーでもこのオンライン ツールを開くことができるため、サブスクリプションは必要ありません。
最終的な考え
これでこのブログ投稿は終わりになります。 Word を C# の Markdown にプログラム的に変換する手順とコード スニペットを説明しました。さらに、GorupDocs.Conversion Cloud SDK を利用したオンライン Markdown ジェネレーターも調査しました。さらに、ドキュメント にアクセスして、他の優れた機能について学ぶこともできます。この記事は、ビジネス アプリケーション用の Docx から MD へのコンバーターの開発を検討している場合に役立ちます。さらに、このプロジェクトはオープンソースであるため、ライブ API こちら や GitHub リポジトリと対話することを忘れないでください。
さらに、スタートガイドに従うことをお勧めします。
最後に、groupdocs.cloud が新しいブログ投稿を書いています。定期的に最新情報をお知らせいたしますので、よろしくお願いいたします。
質問する
ご質問やご質問については、フォーラム でお知らせください。
よくある質問 – FAQ
Word 文書を Markdown に変換するにはどうすればよいですか?
GorupDocs.Conversion Cloud SDK を使用して Doc/Docx を Markdown に変換できます。手順とコード スニペットを確認するには、この リンク にアクセスしてください。
WordをMDファイルに変換できますか?
はい、GorupDocs.Conversion を利用したこの オンライン マークダウン ジェネレーターを使用できます。無料で、数秒で Word を MD に変換します。