HTML Markdown C# を変換する

Markdown は、見出し、太字、斜体、下線などを表す単純な記号を使用したマークアップ言語です。学習と記述が簡単なため、ほとんどのオンライン ドキュメントと readme ファイルはマークダウンを使用して記述されています。いくつかの簡単な手順で、マークダウンを HTML Web ページに簡単に変換できます。同様に、HTML からマークダウンへの変換も便利な機能であり、ここでは C# 言語を使用して検討します。

HTML および Markdown コンバーター – API のインストール

C# プログラミング言語を使用して、HTML Web ページと Markdown 形式のファイルを相互変換できます。これらのファイル フォーマットを操作および変換するには、Aspose.HTML for .NET API をインストールする必要があります。次のインストール コマンドを使用して NuGet ギャラリーから API をインストールするか、ダウンロード セクションから DLL ファイルをダウンロードしてプロジェクトの参照として追加することができます。

PM> Install-Package Aspose.Html

ここまでで、数分で API を構成できるようになります。考えられるさまざまなシナリオを見ていきましょう。

C# でプログラムによって HTML Web ページを Markdown (.md) に変換する

.NET ベースのアプリケーションで、HTML Web ページを Markdown に変換できます。この一般的な変換機能は、基礎となるファイル形式の詳細に入ることなく、API を呼び出すだけでよい方法でサポートされています。したがって、HTML Web ページを変換するには、以下の手順に従う必要があります。

  1. HTML ファイルを作成するか、既存の入力ファイルを読み込みます
  2. MarkdownSaveOptions オブジェクトで ConvertHTML メソッドを呼び出す
  3. 出力マークダウン (.md) ファイルを保存

以下のコードは、C# を使用して HTML Web ページを Markdown に変換する方法を示しています。

// HTML コードを準備し、ファイルに保存します。
var code = "<h1>Header 1</h1>" +
            "<h2>Header 2</h2>" +
            "<p>Hello World!!</p>";
System.IO.File.WriteAllText(dataDir + "document.html", code);

// ConvertHTML メソッドを呼び出して、HTML を Markdown に変換します。
Aspose.Html.Converters.Converter.ConvertHTML(dataDir + "document.html", new Aspose.Html.Saving.MarkdownSaveOptions(), dataDir + "output.md");

C# の追加オプションを使用して HTML Web ページを Markdown MD (.md) に変換する

HTML を Markdown 表記に変換する単純で基本的な使用例については既に学習しました。変換プロセスを制御する別のステップに進みましょう。 HTML ファイルに無関係なデータがたくさんあるが、コンテンツを段落タグまたはハイパーリンク タグに変換するだけでよいというシナリオを考えてみましょう。この機能を理解して試すために、以下の手順に従います。

  1. 入力 HTML ファイルをロードする
  2. MarkdownSaveOptions オブジェクトを初期化する
  3. Features プロパティの下に Flag 変数を設定します。
  4. 出力 Markdown ファイルを保存

以下のコードは、C# を使用して追加のオプションを使用して HTML Web ページを Markdown に変換する方法を示すこれらの手順に基づいています。

// HTML コードを準備し、ファイルに保存します。
var code = "<h1>Header 1</h1>" +
            "<h2>Header 2</h2>" +
            "<p>Hello World!!</p>" +
            "<a href='aspose.com'>aspose</a>";
System.IO.File.WriteAllText(dataDir + "document.html", code);

// SaveOptions のインスタンスを作成し、ルールを設定します。 
// - のみ<a>と</a><p><a>要素はマークダウンに変換されます。</a>
var options = new Aspose.Html.Saving.MarkdownSaveOptions();
options.Features = Aspose.Html.Saving.MarkdownFeatures.Link | Aspose.Html.Saving.MarkdownFeatures.AutomaticParagraph;

// ConvertHTML メソッドを呼び出して、HTML を Markdown に変換します。
Aspose.Html.Converters.Converter.ConvertHTML(dataDir + "document.html", options, dataDir + "output_options.md");

C# を使用してプログラムで Markdown (.md) を HTML Web ページに変換する

シナリオによっては、HTML を Markdown 表記に変換する必要がある場合があります。たとえば、一部のドキュメント セクションは、Web アプリケーションやその他の多くのユース ケースで使用されます。次の手順で、Markdown ファイルを HTML に簡単に変換できます。

  1. Markdown (.md) ファイルを作成するか、入力ファイルを読み込みます
  2. ConvertMarkdownメソッドで出力HTMLファイルを保存

以下のコードは、C# プログラミング言語を使用して Markdown ファイル (.md) を HTML Web ページに変換する方法を示しています。

// 簡単な Markdown の例を準備する
var code = "### Hello World" +
            "\r\n" +
            "[visit applications](https://products.aspose.app/html/family)";
// マークダウン ファイルを作成する
System.IO.File.WriteAllText(dataDir + "input_document.md", code);

// Markdown を HTML ドキュメントに変換する
Aspose.Html.Converters.Converter.ConvertMarkdown(dataDir + "input_document.md", dataDir + "MarkdownToHTMLoutput.html");

サンプル プロジェクトとサンプル ファイルのダウンロード

前述の機能のデモンストレーションとしてサンプル プロジェクトをコンパイルしました。サンプル ファイルをダウンロードすることもできます。これは、マークダウンおよび HTML 相互変換機能を調べて理解するために試すことができるコンソール アプリケーションです。そのため、機能をテストするために、ZIP をダウンロードするか、GitHub リポジトリ のクローンを作成できます。

結論

簡単に言うと、HTML Web ページと Markdown ファイルの変換について詳しく調べました。 API は、単純な API 呼び出しでこれらのファイルを迅速かつ効率的に変換できます。さらに、製品ドキュメント および API リファレンス にアクセスして、他の機能を学習できます。ただし、ご不明な点がございましたら、無料サポート フォーラム からお気軽にお問い合わせください。

関連項目