C# でマークダウン リストを作成する方法
Aspose.HTML for .NET ライブラリは、他のソフトウェアを使用せずに Markdown ファイルを解析および操作できるスタンドアロン ソリューションです。 Markdown ドキュメントをゼロから作成したり、ローカル ファイルから開いたり、新しい要素を挿入したり、既存のノードのコンテンツを削除または編集したりして操作できます。 Markdown は、順序付き (番号付き) および順序なし (箇条書き) のリストをサポートしています。この記事では、C# ライブラリを使用して Markdown でリストを追加する方法について説明します。
Aspose.Html.Toolkit.Markdown.Syntax
と
Aspose.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 順序付きリストを作成する簡単な手順を次に示します。
- MarkdownSyntaxTree() コンストラクターを使用して MarkdownSyntaxTree を作成します。
- SyntaxFactory プロパティを使用して、Markdown 構文ツリーを作成するためのファクトリを取得します。
- SyntaxFactory の OderedList() コンストラクターを使用して、新しいorderedList ノードを作成します。
- OrderedListItem() コンストラクターを使用して、ListItemSyntaxNode クラスの新しいインスタンスを順序付きリスト項目マーカー。
- MarkdownSyntaxNode クラスの AppendChild() メソッドを呼び出して、優先リスト項目をorderedList ノード。
- コンテンツを含むすべての項目が 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 は、他のソフトウェアに依存しない Markdown ドキュメントを操作するためのスタンドアロン ソリューションです。 C# ライブラリをインストールし、ライブラリ参照を C# プロジェクトに追加して、Markdown ドキュメントをプログラムで操作します。
Markdown は、その多用途性により、ライター、開発者、コンテンツ作成者の間で非常に人気があります。 その利点には、学習と使用が簡単な構文、移植性、柔軟性、読みやすさ、使いやすさが含まれます。 Markdown はシンプルで直感的で、HTML、PDF、またはその他の形式に変換できます。
Windows、Mac OS、Linux、Android、または iOS を使用しているかどうかに関係なく、どのオペレーティング システムでも Markdown ドキュメントを操作できます。
C# で作成、開く、解析、編集、保存、または変換できるいくつかのファイル形式がサポートされています。これらは、HTML、XHTML、MHTML、および Markdown 形式です。
Aspose.HTML for .NET API を使ってみる
Aspose.HTML ライブラリ for .NET をシステムにインストールするには、いくつかの方法があります。
- NuGet パッケージ マネージャー GUI を使用して NuGet パッケージ をインストールします。
- パッケージ マネージャー コンソールを使用して NuGet パッケージをインストールします。次のコマンド
PM> Install-Package Aspose.Htmlを使用できます。 - 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 からインストールします。