Markdown ファイルを解析する C# API

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 を解析してテキスト コンテンツを編集してみましょう。

    // 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 を解析して既存のテキスト コンテンツを編集する簡単な手順を検討してください。

1. ソース MD ファイルへのパスを指定し、 MarkdownParser() コンストラクターを使用して、MarkdownParser クラスの新しいインスタンスを初期化します。
2. ParseFile() メソッドを呼び出して、Markdown を解析し、構文ツリーを取得します。 .
3. TreeWalker オブジェクトを作成し、Markdown 構文ツリーをナビゲートして、不要なコンテンツ (EmphasisSyntax ノード) を削除します。
4. SyntaxFactory プロパティを使用して、新しい要素を作成するための構文ファクトリを取得します。
5. 新しいテキスト ノードを作成し、テキスト コンテンツを新しい強調に追加します。
6. AppendChild() メソッドを使用して、新しいノードを構文ツリーに追加します。
7. 編集した MD ファイルを Save() メソッドで保存します。

ドキュメンテーション

Aspose.HTML API の詳細については、 ドキュメント ガイドをご覧ください。 GitHub リポジトリからサンプルをダウンロードできます。それらはオープンソースであり、独自のアプリケーションで自由に使用できます。

Markdown は、プレーン テキストを書式設定できるシンプルなマークアップ言語です。 MD の作成者である John Gruber は、可能な限り読みやすくすることを目標に、Markdown の書式設定構文を設計しました。マークダウンは、読みやすく、書きやすいスタイルで記述できるため、ドキュメントや readme ファイルの形式としてよく使用されます。 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 からインストールします。