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 構文の例に関する情報を提供しています。


よくある質問

1. C# で Markdown を作成、解析、編集するにはどうすればよいですか?

Aspose.HTML Library for .NET は、他のソフトウェアに依存しない Markdown ドキュメントを操作するためのスタンドアロン ソリューションです。 C# ライブラリをインストールし、ライブラリ参照を C# プロジェクトに追加して、Markdown ドキュメントをプログラムで操作します。

2. なぜマークダウンはこれほど人気があるのでしょうか?

Markdown は、その多用途性により、ライター、開発者、コンテンツ作成者の間で非常に人気があります。 その利点には、学習と使用が簡単な構文、移植性、柔軟性、読みやすさ、使いやすさが含まれます。 Markdown はシンプルで直感的で、HTML、PDF、またはその他の形式に変換できます。

3. Linux、Mac OS、Android、または iOS で Markdown ファイルを操作できますか?

Windows、Mac OS、Linux、Android、または iOS を使用しているかどうかに関係なく、どのオペレーティング システムでも Markdown ドキュメントを操作できます。

4. Aspose.HTML C# ライブラリで処理できるファイル フォーマットは?

C# で作成、開く、解析、編集、保存、または変換できるいくつかのファイル形式がサポートされています。これらは、HTML、XHTML、MHTML、および Markdown 形式です。



.NET HTML 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 からインストールします。