C# で Markdown 段落を作成する方法

Aspose.HTML for .NET ライブラリは、他のソフトウェアを使用せずに Markdown ファイルを解析および操作できるスタンドアロン ソリューションです。 Markdown ドキュメントをゼロから作成したり、ローカル ファイルから開いたり、新しい要素を挿入したり、既存のノードのコンテンツを削除または編集したりして操作できます。

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


C# で Markdown 段落を追加する方法

C# ライブラリを使用すると、MD ファイルをプログラムで編集して、ドキュメントの構造と内容を変更できます。 C# で MD 段落要素を作成する機能があります。テキストノード、テキストノード間のスペース、段落後の空白行など、いくつかのノードから段落を組み立てる必要があるのが特徴です。新しい Markdown ドキュメントをゼロから作成し、それに 2 つの段落を追加する方法を見てみましょう。

MD ファイルを編集する C# コード

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

    // Use the SyntaxFactory property to get the factory for creating the Markdown syntax tree
    var mdf = md.SyntaxFactory;

    // Create an empty paragraph1
    var paragraph1 = mdf.Paragraph();

    // Add texts to the paragraph1
    paragraph1.AppendChild(mdf.Text("The first sentence of the first paragraph."));
    // Add a space after the first sentence in the paragraph through a special WhiteSpace node
    paragraph1.AppendChild(mdf.Whitespace());

    paragraph1.AppendChild(mdf.Text("The second sentence of the first paragraph."));

    // Create and add newLineTrivia element for an empty line after paragraph1 
    var newLineTrivia = mdf.NewLineTrivia();
    paragraph1.GetTrailingTrivia().Add(newLineTrivia);

    // Add the filled paragraph1 into MD document
    md.AppendChild(paragraph1);

    // Create an empty paragraph2
    var paragraph2 = mdf.Paragraph();

    // Add texts to the paragraph2
    paragraph2.AppendChild(mdf.Text("The first sentence of the second paragraph."));
    // Add a space after the first sentence in the paragraph through a special WhiteSpace node
    paragraph2.AppendChild(mdf.Whitespace());

    paragraph2.AppendChild(mdf.Text("The second sentence of the second paragraph."));

    // Add newLineTrivia element for an empty line after paragraph2
    paragraph2.GetTrailingTrivia().Add(newLineTrivia);

    // Add the filled paragraph2 into MD document as a last child
    md.AppendChild(paragraph2);

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

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



C# で Markdown 段落を作成する手順

コンポーネントノードから段落を組み立てる必要があることを思い出してください。 Markdown 段落を作成する簡単な手順を検討してください。

  1. SyntaxFactory の Paragraph() コンストラクターを使用して、新しい空の段落ノードを作成します。
  2. Text() コンストラクターを使用して、段落のテキスト ノードを作成します。
  3. MarkdownSyntaxNode クラスの AppendChild() メソッドを呼び出して、テキスト ノードと空白を追加します。段落に。
  4. Whitespace() コンストラクターを使用して、段落内のテキスト ノード間にスペースを作成します。 .
  5. パラグラフの後の空行に newLineTrivia 要素を作成して追加します。 NewLineTrivia() コンストラクターと Add() メソッドを使用します。
  6. すべての段落ノードが 1 つの要素に集められたら、それをドキュメント構文ツリーに追加します。

C# で既存の MD ファイルに Markdown 段落を追加する

次の C# コード例は、既存の MD ドキュメントに段落を追加する方法を示しています。

段落を追加する C# コード

    // 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 syntaxTree = parser.ParseFile(input);

    // Get a SyntaxFactory to create new elements 
    var syntaxFactory = syntaxTree.SyntaxFactory;

    // Create a new empty paragraph 
    var paragraphSyntaxNode = syntaxFactory.Paragraph();

    // Create and add newLineTrivia element for an empty line after paragraph 
    var newLineTrivia = syntaxFactory.NewLineTrivia();
    paragraphSyntaxNode.GetTrailingTrivia().Add(newLineTrivia);
            
    // Create text content for the paragraph 
    var textSyntaxNode = syntaxFactory.Text("Markdown language is simple to learn. It has minimal extra characters, so you can quickly write and make fewer errors.");

    // Add text into paragraph
    paragraphSyntaxNode.AppendChild(textSyntaxNode);

    // Add paragraph to MD document before the first element of the syntax tree
    syntaxTree.InsertBefore(paragraphSyntaxNode, syntaxTree.FirstChild);

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

    // Save Markdown file
    syntaxTree.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 からインストールします。