C# でマークダウン リストを作成する方法

Aspose.HTML for .NET ライブラリは、他のソフトウェアを使用せずに Markdown ファイルを解析および操作できるスタンドアロン ソリューションです。 Markdown ドキュメントをゼロから作成したり、ローカル ファイルから開いたり、新しい要素を挿入したり、既存のノードのコンテンツを削除または編集したりして操作できます。 Markdown は、順序付き (番号付き) および順序なし (箇条書き) のリストをサポートしています。この記事では、C# ライブラリを使用して Markdown でリストを追加する方法について説明します。

Aspose.Html.Toolkit.Markdown.SyntaxAspose.Html.Toolkit.Markdown.Parser 名前空間は、GitHub Flavored Markdown (GFM) 仕様に基づいて完全な Markdown 解析と MD 構文ツリー管理を提供します.


C# で Markdown 順序付きリストを作成する

C# ライブラリを使用すると、MD ファイルをプログラムで編集して、ドキュメントの構造と内容を変更できます。新しい Markdown ドキュメントをゼロから作成し、それに Markdown 順序付きリストを追加する方法を見てみましょう。

Markdown 順序付きリストを作成する C# コード

    // Create the MarkdownSyntaxTree
    var md = new MarkdownSyntaxTree(new Configuration());

    // Create a Markdown syntax factory
    var mdf = md.SyntaxFactory;

    // Create a new empty odered list node
    var orderedList = mdf.OrderedList();

    // Create and add to the odered list a li1 item with the marker “1”
    var li1 = mdf.OrderedListItem(1);
    orderedList.AppendChild(li1);

    // Create a paragraph with text content and add it to the li1 item
    var paragraph = mdf.Paragraph();

    var heading = mdf.AtxHeading("The first element in the Markdown ordered list is the level 3 heading.", 3);
    paragraph.AppendChild(heading);
    li1.AppendChild(paragraph);

    //Create and add to the odered list a li2 item with the marker “2”
    var li2 = mdf.OrderedListItem(2);
    orderedList.AppendChild(li2);

    // Create a strong emphasis with text content and add it to the li2 item
    var bold = mdf.Emphasis(Emphasis.Strong);

    bold.AppendChild(mdf.Text("The second item in the Markdown ordered list is in bold."));
    li2.AppendChild(bold);

    // Add orderedList to MD syntax tree
    md.AppendChild(orderedList);

    // Prepare a path for MD file saving 
    string savePath = Path.Combine(OutputDir, "output-odered-list.md");

    // Save MD file
    md.Save(savePath);



C# で Markdown 順序付きリストを作成する手順

Markdown 順序付きリストを作成する簡単な手順を次に示します。

  1. MarkdownSyntaxTree() コンストラクターを使用して MarkdownSyntaxTree を作成します。
  2. SyntaxFactory プロパティを使用して、Markdown 構文ツリーを作成するためのファクトリを取得します。
  3. SyntaxFactory の OderedList() コンストラクターを使用して、新しいorderedList ノードを作成します。
  4. OrderedListItem() コンストラクターを使用して、ListItemSyntaxNode クラスの新しいインスタンスを順序付きリスト項目マーカー。
  5. MarkdownSyntaxNode クラスの AppendChild() メソッドを呼び出して、優先リスト項目をorderedList ノード。
  6. コンテンツを含むすべての項目が 1 つの orderedList 要素に集められたら、それをドキュメント構文ツリーに追加します。

C# で順序付けられていない Markdown リストを作成する

次の C# コード例は、順序付けられていないリストを MD ファイルに追加する方法を示しています。

順序付けられていないリストを MD ファイルに追加する C# コード

// Create the MarkdownSyntaxTree
    var md = new MarkdownSyntaxTree(new Configuration());

    // Create a Markdown syntax factoty
    var mdf = md.SyntaxFactory;

    // Create a new empty unodered list node
    var unorderedList = mdf.UnorderedList();

    // Create and add to the unodered list a li1 element with the marker “-”
    var li1 = mdf.UnorderedListItem("-");
    unorderedList.AppendChild(li1);

    // Create a paragraph with text content and add it to the li1 item:
    var paragraph = mdf.Paragraph();
    paragraph.AppendChild(mdf.Text("The first item of the unordered Markdown list."));
    li1.AppendChild(paragraph);

    // Create and add to the unodered list a li2 element with the marker “-”
    var li2 = mdf.UnorderedListItem("-");
    unorderedList.AppendChild(li2);

    // Create a paragraph with text content and add it to the li2 item:
    var paragraph2 = mdf.Paragraph();
    paragraph2.AppendChild(mdf.Text("The second item of the unordered Markdown list."));
    li2.AppendChild(paragraph2);

    // Add unorderedList to MD syntax tree
    md.AppendChild(unorderedList);

    // Prepare a path for MD file saving 
    string savePath = Path.Combine(OutputDir, "markdown-unodered-list.md");

    // Save MD file
    md.Save(savePath);

ドキュメンテーション

Aspose.HTML API の詳細については、 ドキュメント ガイドをご覧ください。 Markdown は、プレーン テキストを書式設定できるシンプルなマークアップ言語です。 Markdown Syntax ドキュメント記事では、主な Markdown 要素、詳細、および Markdown 構文の例に関する情報を提供しています。


Aspose.HTML for .NET API を使ってみる

Aspose.HTML ライブラリ for .NET をシステムにインストールするには、いくつかの方法があります。

  1. NuGet パッケージ マネージャー GUI を使用して NuGet パッケージ をインストールします。
  2. パッケージ マネージャー コンソールを使用して NuGet パッケージをインストールします。次のコマンド PM> Install-Package Aspose.Html を使用できます。
  3. MSI から Aspose.HTML for .NET をインストールします。

このライブラリは、HTML5、CSS3、SVG、および HTML Canvas の解析をサポートし、WHATWG DOM 標準に基づくドキュメント オブジェクト モデル (DOM) を構築します。 Aspose.HTML for .NET は完全に C# で記述されており、ASP.NET、WCF、WinForms、.NET Core など、あらゆるタイプの 32 ビットまたは 64 ビットの .NET アプリケーションの構築に使用できます。 .NET 変換サンプル コードを実行する前に、Microsoft Windows または .NET Framework または .NET Standard と互換性のある OS と、Microsoft Visual Studio などの開発環境があることを確認してください。 C# ライブラリのインストールとシステム要件の詳細については、 Aspose.HTML ドキュメント を参照してください。

システム要求

当社の API は、すべての主要なプラットフォームとオペレーティング システムでサポートされています。コードを実行する前に、システムに次の前提条件があることを確認してください。

  • Microsoft Windows または .NET Framework、.NET Core、Windows Azure、Mono、または Xamarin プラットフォームと互換性のある OS。
  • Microsoft Visual Studio のような開発環境。
  • プロジェクトで参照される .NET DLL 用の Aspose.Html – 上記の [ダウンロード] ボタンを使用して NuGet からインストールします。