Markdown ファイルを解析する C# API
C# ライブラリ機能を使用して、MD ドキュメントの既存のノードの要素を作成、削除、またはコンテンツを編集します。
C# を使用して Markdown ファイルを解析する
Aspose.HTML for .NET
ライブラリは、C# プラットフォーム用の Markdown 解析 API を提供します。
Aspose.Html.Toolkit.Markdown.Parser
名前空間には、完全な Markdown 解析を提供するクラスとメソッドが含まれていますとレンダリング。
リンクをたどることで、MD ファイルを作成、編集、保存、マージ、他のファイル形式に変換し、リンク、リスト、コード ブロック、画像、その他の要素を Markdown ファイルに追加できます。
C# で Markdown を解析する方法
C# でプログラムによって Markdown を編集するタスクは、MD ドキュメント ツリー内の要素を変更することです。 Aspose.HTML for .NET API は、GitHub Flavored Markdown Spec で定義されている一連の MD 要素と、要素をネストする方法に関する規則をサポートしています。さらに、 Aspose.Html.Toolkit.Markdown.Extensions 名前空間には、Markdown 構文を操作するためのクラスとメソッドが含まれています。 GFM 仕様の一部ではない仕様に基づくツリー。 Markdown を解析して編集するための簡単な手順を検討してください。 Markdown を解析してテキスト コンテンツを編集してみましょう。
C# で Markdown を解析して編集する
// Specify the path to the source MD file
var input = "C:/temp/input.md";
// Create a MarkdownParser object
var parser = new MarkdownParser();
// Parse the MD document and get a syntax tree
var markdown = parser.ParseFile(input);
// Create a TreeWalker object and navigate through the syntax tree starting at the first node
using var iterator = markdown.CreateTreeWalker(markdown.FirstChild);
while (iterator.NextNode() != null)
{
// Check the type of the current node as EmphasisSyntax
if (iterator.CurrentNode is EmphasisSyntaxNode)
{
var node = (EmphasisSyntaxNode)iterator.CurrentNode;
var n = node.FirstChild;
while (n != null)
{
var next = n.NextSibling;
// Remove the EmphasisSyntax node
node.RemoveChild(n);
n = next;
}
// Get a SyntaxFactory to create new elements
var syntax = markdown.SyntaxFactory;
// Add the text to a new node
node.AppendChild(syntax.Text("new text with"));
// Add whitespase
node.AppendChild(syntax.Whitespace());
// Create an emphasis object
var emphasis = syntax.Emphasis(Emphasis.Strong);
// Add the text into empasis and accumulate a new node
emphasis.AppendChild(syntax.Text("strong emphasis!"));
node.AppendChild(emphasis);
break;
}
}
// Prepare a path for MD file saving
string savePath = Path.Combine(OutputDir, "output-edit.md");
// Save MD file
markdown.Save(savePath);
C# で Markdown を解析および編集する手順
Markdown を解析して既存のテキスト コンテンツを編集する簡単な手順を検討してください。
- ソース MD ファイルへのパスを指定し、 MarkdownParser() コンストラクターを使用して、MarkdownParser クラスの新しいインスタンスを初期化します。
- ParseFile() メソッドを呼び出して、Markdown を解析し、構文ツリーを取得します。 .
- TreeWalker オブジェクトを作成し、Markdown 構文ツリーをナビゲートして、不要なコンテンツ (EmphasisSyntax ノード) を削除します。
- SyntaxFactory プロパティを使用して、新しい要素を作成するための構文ファクトリを取得します。
- 新しいテキスト ノードを作成し、テキスト コンテンツを新しい強調に追加します。
- AppendChild() メソッドを使用して、新しいノードを構文ツリーに追加します。
- 編集した MD ファイルを Save() メソッドで保存します。
ドキュメンテーション
Aspose.HTML API の詳細については、
ドキュメント
ガイドをご覧ください。
GitHub
リポジトリからサンプルをダウンロードできます。それらはオープンソースであり、独自のアプリケーションで自由に使用できます。
Markdown は、プレーン テキストを書式設定できるシンプルなマークアップ言語です。 MD の作成者である John Gruber は、可能な限り読みやすくすることを目標に、Markdown の書式設定構文を設計しました。マークダウンは、読みやすく、書きやすいスタイルで記述できるため、ドキュメントや readme ファイルの形式としてよく使用されます。
Markdown Syntax
ドキュメント記事では、主な Markdown 要素、詳細、および Markdown 構文の例に関する情報を提供しています。
Aspose.HTML for .NET のインストール
.NET CLI を使用して、NuGet から Aspose.HTML for .NET をインストールします。
dotnet add package Aspose.HTML
NuGet パッケージ マネージャーの UI を使用するか、パッケージ マネージャー コンソールで Install-Package Aspose.HTML を実行することもできます。セットアップの詳細は
インストール ガイド
を参照してください。評価制限なしで API を試すには、
一時ライセンス
を申請できます。
システム要求
当社の API は、すべての主要なプラットフォームとオペレーティング システムでサポートされています。コードを実行する前に、システムに次の前提条件があることを確認してください。
- Microsoft Windows または .NET Framework、.NET Core、Windows Azure、Mono、または Xamarin プラットフォームと互換性のある OS。
- Microsoft Visual Studio のような開発環境。
- プロジェクトで参照される .NET DLL 用の Aspose.Html – 上記の [ダウンロード] ボタンを使用して NuGet からインストールします。