.NET REST API を使用して HTML から Markdown (MD) への変換を効率化する

コンテンツは日々、さまざまなプラットフォームや媒体に広がっています。そのため、適応性が高くプラットフォームに依存しないフォーマットがこれまで以上に重要になっています。ここで、[HTML][] から Markdown (MD) 形式への移行が極めて重要なソリューションとして浮上します。Markdown はシンプルで互換性があるため、コンテンツ作成者、開発者、および情報をより効率的に提示する方法を求める人にとって理想的な選択肢です。さらに、HTML を Markdown に変換することで、コンテンツの読みやすさとアクセシビリティが確保されるだけでなく、さまざまなプラットフォーム間でシームレスに共有できるようになります。

この記事では、.NET Cloud SDK を使用して HTML を Markdown に変換する方法について詳しく説明します。

• HTML から Markdown への変換のための Cloud SDK
• C# .NET で HTML を Markdown に変換する
• cURL コマンドを使用して HTML を Markdown に変換する

HTML から Markdown への変換のための Cloud SDK

Aspose.HTML Cloud SDK for .NET を使用すると、HTML を Markdown (MD) 形式にシームレスに変換できるソリューションが提供され、コンテンツ変換エクスペリエンスが向上します。この強力な SDK により、開発者とユーザーは、コンテンツの整合性と構造を維持しながら、複雑な ‘html から markdown’ への変換を簡単に実行できます。

SDK を使用するには、NuGet パッケージ マネージャーで Aspose.HTML-Cloud を検索し、パッケージの追加 ボタンをクリックします。さらに、クラウド ダッシュボード にアクセスして、カスタマイズされたクライアント資格情報を取得してください。

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

C# .NET を使用した HTML から Markdown への変換の詳細を見てみましょう。

// 完全な例については、https://github.com/aspose-html-cloud/aspose-html-cloud-dotnet をご覧ください。

string clientSecret = "4d84d5f6584160cbd91dba1fe145db14";
string clientID = "bb959721-5780-4be6-be35-ff5c3a6aa4a2";

// ベースURL文字列
const string SERVICE_API_HOST = "https://api.aspose.cloud";

// HtmlApiインスタンスを作成する
HtmlApi htmlApi = new HtmlApi(clientID, clientSecret, SERVICE_API_HOST);       

// 入力HTMLファイルの名前
String inputFileName = "source.html";

// 出力ファイル名
String newFileName = "Converted.md";
 
try
{

    // ローカルドライブからファイルを読み込む
    using (var file = System.IO.File.OpenRead(@"C:\Users\" + inputFileName))
    {
        // StorageApiインスタンスを作成する
        var uploadFileRequest = new Aspose.Html.Cloud.Sdk.Api.StorageApi(clientID, clientSecret, SERVICE_API_HOST);

        // HTMLファイルをクラウドストレージにアップロードする
        uploadFileRequest.UploadFile(file, "inputHTML.html");
    }

    // HTMLからMarkdownへの変換操作を開始し、出力をクラウドストレージに保存します。
    AsposeResponse response = htmlApi.PutConvertDocumentToMarkdown(inputFileName,newFileName);

    // 変換が成功した場合は成功メッセージを出力します
    if (response != null && response.Equals("OK"))
    {
        Console.WriteLine("Successfull completion of HTML to MD !");
    }
            
catch (Exception ex)
{
    Console.WriteLine("error:" + ex.Message + "\n" + ex.StackTrace);
}
copy

それでは、上記のコード スニペットの詳細を調べてみましょう。

HtmlApi htmlApi = new HtmlApi(clientID, clientSecret);
copy

まず、クライアントの資格情報を引数として渡す HtmlApi クラスのインスタンスを作成します。

AsposeResponse response = htmlApi.PutConvertDocumentToMarkdown(inputFileName,newFileName);
copy

API を呼び出して、HTML から Markdown への変換操作を開始します。操作が成功すると、結果の MD ファイルがクラウド ストレージに保存されます。

cURL コマンドを使用して HTML を Markdown に変換する

Aspose.HTML Cloud と cURL コマンドの優れた機能を組み合わせて、HTML から Markdown (MD) 形式への変換を効率化します。Aspose.HTML Cloud API と対話する cURL コマンドを作成することで、HTML から Markdown へのシームレスな移行を開始できます。この方法では、コンテンツの構造と書式設定も保持できるため、変換されたドキュメントの読みやすさとプレゼンテーション品質が維持されます。

さて、このアプローチでは、最初のステップとして、次のコマンドを実行して JWT アクセス トークンを生成します。

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"
copy

JWT アクセス トークンを取得したので、次のコマンドを実行して、クラウド ストレージから入力 HTML を読み込み、それを Markdown (MD) 形式に変換して、結果のファイルをローカル ドライブに保存します。

curl -v "https://api.aspose.cloud/html/{inputHTML}/convert/md?outPath={resultantFile}&useGit=false" \
-X PUT \
-H  "accept: application/json" \
-H  "authorization: Bearer {accessToken}" \
-d {}
copy

inputHTML をクラウド ストレージで既に使用可能な入力 HTML ファイルの名前に置き換え、resultantFile を使用可能な結果の Markdown ファイルの名前に置き換え、accessToken を上記で生成された JWT アクセス トークンに置き換えます。

結論

結論として、HTML から Markdown (MD) 形式への変換は、コンテンツの互換性、読みやすさ、およびさまざまなプラットフォーム間での共有を向上させるための極めて重要なステップとなります。Aspose.HTML Cloud SDK for .NET と cURL コマンドの使用という 2 つの動的なアプローチを利用できるため、技術的な専門知識と要件に合った方法を柔軟に選択できます。それでも、Aspose.HTML Cloud を活用すると、コンテンツの整合性をシームレスに維持しながら、HTML から Markdown への変換を正確に実行できます。

便利なリンク

• 開発者ガイド

• APIリファレンス

• SDKソースコード

• 無料サポートフォーラム

• ライブデモ

関連記事

以下のブログをご覧になることを強くお勧めします。

• .NET REST API を使用して PDF を Word に変換する方法
• .NET REST API を使用して EPUB を PDF に変換する
• .NET REST API を使用した HTML から Word 文書への変換