Markdown が習得しやすく、書式設定されたテキストの記述が非常に簡単になることは明らかです。実際、MD ファイルを PDF、DOCX、HTML などの他の一般的なファイル形式に簡単に変換できます。ただし、GorupDocs.Conversionは、さまざまなファイル形式をプログラムで変換および操作するための、複数のプログラミング言語での SDK を提供します。さらに、GorupDocs.Conversion が提供する REST API を利用することもできます。そこで、このブログ投稿では、GorupDocs.Conversion Cloud SDK for .NET を使用して C# で Markdown を HTML に変換する方法を学びます。さらに、GorupDocs.Conversion Cloud SDK を利用した オンライン MD から HTML へのコンバーターもあります。
この記事では次の点について説明します。
マークダウン変換 API のインストール
GorupDocs.Conversion Cloud SDK for .NET はエンタープライズレベルのクラウドベースのソリューションを提供しており、幸いなことに、インストールとセットアップは非常に簡単です。この NuGet パッケージ をダウンロードして、この HTML ファイル ジェネレーター ライブラリをインストールすることも、NuGet パッケージ マネージャーで次のコマンドを実行することもできます。
Install-Package GroupDocs.Conversion-Cloud -Version 23.10.0
C# でマークダウンを HTML に変換する
インストールが成功したら、次のステップは API 認証情報を取得することです。これも非常に簡単で、アプリケーションのクライアント ID とクライアント シークレットは API クラウド ダッシュボード から取得できます。ただし、この Markdown 変換 API の API 認証情報を取得する方法については、ガイド を参照してください。
コード スニペットを記述する前の最後に、API Cloud ダッシュボードにソース Markdown ファイルがすでに存在していることを確認してください。ただし、この HTML ファイル ジェネレーター ライブラリの UploadFile メソッドを呼び出すことで、ファイル アップロード タスクを自動化できます。
ここで、次の手順を実行して、プログラムで Markdown を HTML に変換します。
- Configuration クラスのインスタンスを初期化し、クライアント シークレットとクライアント ID を使用して初期化します。
- ApiBaseUrl の値を定義して、Markdown 変換 API のベース URL を設定します。
- Configuration クラスのオブジェクトを使用して、ConvertApi クラスのオブジェクトを作成します。
- ConvertSettings クラスのインスタンスをインスタンス化し、FilePath、Format、OutputPath などの値を設定して初期化します。
- ConvertDocument メソッドは、Markdown をプログラム的に HTML に変換します。
次のコード サンプルは、C# で MD を HTML に変換します。
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# でマークダウンを HTML に変換する
class Convert_MD_to_HTML
{
static void Main(string[] args)
{
try
{
// API 認証情報を取得する
string clientId = "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx";
string clientSecret = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx";
string myStorage = "test";
// Configuration クラスのインスタンスを初期化し、クライアント シークレットとクライアント ID を使用して初期化します。
var configuration = new Configuration(clientId, clientSecret);
// ApiBaseUrl の値を定義して、Markdown 変換 API のベース URL を設定します。
configuration.ApiBaseUrl = "https://api.groupdocs.cloud";
// Configuration クラスのオブジェクトを使用して ConvertApi クラスのオブジェクトを作成します。
var apiInstance = new ConvertApi(configuration);
// ConvertSettings クラスのインスタンスをインスタンス化し、FilePath、Format、OutputPath などの値を設定して初期化します。
var settings = new ConvertSettings
{
FilePath = "sample.md",
Format = "html",
OutputPath = "test/sample.html"
};
// ConvertDocument メソッドは、マークダウンをプログラム的に HTML に変換します。
var response = apiInstance.ConvertDocument(new ConvertDocumentRequest(settings));
Console.WriteLine("Successfully converted Markdown to HTML in C#: " + response[0].Url);
}
catch (Exception e)
{
Console.WriteLine("Exception when calling GroupDocs.Conversion Api: " + e.Message);
}
}
}
}
結果の HTML ファイルは、API クラウド ダッシュボード の「test」フォルダーに生成されます。したがって、この Markdown 変換 API の DownloadFile メソッドを呼び出すことで、ファイルを手動またはプログラムでダウンロードできます。
オンライン MD から HTML へのコンバーター
ここまでで、.NET アプリケーションでプログラムによって Markdown を HTML に変換する方法を学習しました。次に、ブラウザベースの オンライン Markdown to HTML コンバータを使用して、この MD から HTML への変換を自動化できます。これは非常に高速、効率的、安全であり、ドラッグ アンド ドロップのユーザー インターフェイスが付属しています。このオンラインツールは無料で、サブスクリプションも必要ないため、ぜひ体験してみることを強くお勧めします。
最終的な考え
これでこのブログ投稿は終わりです。このガイドは特に .NET 開発者向けですが、GorupDocs.Conversion Cloud SDK は複数の一般的なプログラミング言語で見つけることができます。したがって、ビジネス アプリケーション用に任意のプログラミング言語で MD から HTML へのコンバータ モジュールを開発できます。 C# で Markdown を HTML に変換する方法を学習できたことを願っています。他の機能については、ドキュメント にアクセスしてください。何よりも、こちら のライブ クラウド API を操作できます。さらに、この .NET ラッパーをカスタマイズするために GitHub リポジトリを複製することができます。その前に、Getting Started guide を確認する必要があります。
最後に、groupdocs.cloud が新しいブログ投稿を書いています。定期的に最新情報をお知らせいたしますので、よろしくお願いいたします。
質問する
ご質問やご質問については、フォーラム でお知らせください。
よくある質問 – FAQ
Markdown ファイルを HTML に変換するにはどうすればよいですか?
この Web ベースの オンライン ツールを使用して MD を HTML に変換できます。このツールは GorupDocs.Conversion Cloud SDK を利用しています。
Visual Studio で Markdown から HTML を生成するにはどうすればよいですか?
答えの詳細については、この リンク を参照してください。