ワードからマークダウンへ

C# .NET で Word を Markdown に変換する

私たちの日常生活では、さまざまな目的に応じてさまざまな文書形式が使用されています。 Markdown (MD) は、Web サイト、ブログ、その他のオンライン プラットフォームのコンテンツを作成するための一般的な形式になっています。一方、Microsoft Word は、文書の作成および編集に最も広く使用されているワープロ ツールの 1 つです。ただし、コンテンツをオンラインで公開する場合、Word 文書 (DOC/DOCX) は書式設定が複雑なため、最適な選択ではない可能性があります。この場合、Word 文書を Markdown 形式に変換すると便利です。この記事では、C# と REST API を使用して Word ドキュメントを Markdown (MD) 形式に変換する方法について説明します。

Markdown は、複雑な書式設定ツールを使用せずにテキストの書式を簡単に設定できるため、文書作成、特に技術的および科学的文書の作成によく使用されます。

Word から Markdown への変換 API

Aspose.Words Cloud は、開発者が Word から Markdown への変換などのさまざまなドキュメント処理タスクを実行できるようにする REST API です。 Aspose.Words Cloud SDK for .NET を利用すると、.NET アプリケーションでこの API を簡単に使用できます。 Word ドキュメントを Markdown 形式に変換するシンプルかつ効率的な方法を提供し、コア アプリケーション ロジックに集中できるようになります。

SDK を使用するには、NuGet パッケージ マネージャーで「Aspose.Words-Cloud」を検索し、[パッケージの追加] ボタンをクリックします。次に、クラウド ダッシュボード からクライアントの認証情報を取得します。

既存のアカウントをお持ちでない場合は、有効な電子メール アドレスを使用して無料アカウントを作成してください。

C# で Word から MD へ

C# .NET を使用して Word を MD に変換するには、次のコード スニペットを使用してみてください。

// https://dashboard.aspose.cloud/ からクライアントの認証情報を取得します。
string clientSecret = "d757548a9f2558c39c2feebdf85b4c44";
string clientID = "4db2f826-bf9c-42e7-8b2a-8cbca2d15553";

// ClinetID とクライアント シークレットの詳細を使用して構成オブジェクトを作成する
var config = new Configuration { ClientId = clientID, ClientSecret = clientSecret };
// WordsApi インスタンスを初期化する
var wordsApi = new WordsApi(config);

// 入力ファイル名
String inputFile = "test_doc.docx";

// 結果のファイルの名前
String resultant = "resultant.md";

// 結果のファイル形式
String format = "MD";
try
{
    // ローカルドライブからファイルをロードします
    using (var file = System.IO.File.OpenRead(inputFile))
    {
        var uploadFileRequest = new UploadFileRequest(file, inputFile);
        
        // ファイルをクラウドストレージにアップロードする
        wordsApi.UploadFile(uploadFileRequest);
   }
    
    // DocumentWithFormatリクエストオブジェクトを作成する
    var response = new GetDocumentWithFormatRequest(inputFile, format,outPath: resultant);
    
    // ドキュメント操作をトリガーする
    wordsApi.GetDocumentWithFormat(response);

    // 変換が成功した場合は成功メッセージを出力します
    if (response != null && response.Equals("OK"))
    {
        Console.WriteLine("Word to Markdown conversion successfull !");
        Console.ReadKey();
    }
}catch (Exception ex)
{
    Console.WriteLine("error:" + ex.Message + "\n" + ex.StackTrace);
}
マークダウンへのワード

画像:- Word から Markdown への変換プレビュー。

各コード行の詳細を以下に示します。

  • まず、クライアント ID とクライアント シークレットの資格情報を引数として渡しながら、Configuration クラスのインスタンスを作成しました。
  • 次に、Configuration オブジェクトを引数として渡す WordsApi のオブジェクトを作成します。
  • 3 番目に、入力 Word ドキュメントをローカル ドライブから読み取り、UploadFile(…) メソッドを使用してクラウド ストレージにアップロードします。
  • 次に、入力ファイル名、MD としての結果の形式、および引数として結果のファイル名を渡す GetDocumentWithFormatRequest のインスタンスを作成します。
  • 最後に、GetDocumentWithFormat(..) メソッドを呼び出して、Word から Markdown への変換を実行します。変換後、結果のファイルもクラウド ストレージに保存されます。

上記の例で使用されているサンプル Word ドキュメントは、testdoc.docx からダウンロードできます。 )。

cURLコマンドを使用したDOCからMarkdownへの変換

cURL コマンドと Aspose.Words Cloud を利用すると、カスタム コードを記述することなく、Word ドキュメントを Markdown 形式に迅速かつ簡単に変換できます。このアプローチにより、既存のワークフローやツールとのシームレスな統合が可能になり、時間と労力を節約できます。そのため、cURL コマンドと Aspose.Words Cloud を使用して Word から Markdown に変換すると、ドキュメント変換のニーズに合わせたシンプルで効率的でカスタマイズ可能なソリューションが提供されます。

このアプローチを開始するには、(クライアントの資格情報に基づいて) accessToken を生成する必要があります。次のコマンドを実行してください。

curl -v "https://api.aspose.cloud/connect/token" \
-X POST \
-d "grant_type=client_credentials&client_id=bb959721-5780-4be6-be35-ff5c3a6aa4a2&client_secret=4d84d5f6584160cbd91dba1fe145db14" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Accept: application/json"

{accessToken} が生成されたら、次のコマンドを実行して Word 文書をクラウド ストレージから読み込み、Markdown (md) 形式に変換します。出力をローカル ドライブに保存する -o パラメーターを使用しました。

curl -v "https://api.aspose.cloud/v4.0/words/test_doc.docx?format=MD" \
-X GET \
-H  "accept: application/octet-stream" \
-H  "Authorization: Bearer <accessToken>" \
-o "resultant.md"

結論

結論として、Word ドキュメントを Markdown 形式に変換する機能により、開発者、ブロガー、テクニカル ライターのコンテンツ作成プロセスが大幅に簡素化されます。 Aspose.Words Cloud は、.NET SDK または cURL コマンドを柔軟に使用できる、この変換を実現するためのシンプルかつ強力なソリューションを提供します。このツールを使用すると、ユーザーは Word 文書を Markdown 形式に簡単に変換でき、コンテンツ作成プロセスの貴重な時間と労力を節約できます。

役立つリンク

関連記事

詳細については、次のリンクを参照してください。