C# での Markdown Text と Markdown Blockquote

C# ライブラリを使用して、ゼロから Markdown を作成し、MD ファイルを開いたり、解析したり、編集したりします。

C# で Markdown テキストを作成する方法

HTML と同様に、Markdown はマークアップ言語です。 HTML とは異なり、Markdown はできるだけ読みやすくすることを目指しています。太字、斜体、引用符、および取り消し線をテキストに適用できます。また、複数のスタイルを同時に使用するために組み合わせて使用することもできます。 Aspose.HTML for .NET ライブラリは、他のソフトウェアを使用せずに Markdown ファイルを解析および操作できるスタンドアロンソリューションです。 Markdown ドキュメントを最初から作成し、ローカルファイルから開き、新しい要素を挿入して操作し、既存のノードのコンテンツを削除または編集することができます。

MarkdownSyntaxFactory クラスには、さまざまな Markdown 要素を作成するためのメソッドが含まれています。ヘッダーの作成には、Atx ヘッダーを作成する AtxHeading() メソッドを使用できます。テキストコンテンツを含む構文ノード。 Emphasis() メソッドを使用して、Emphasis 列挙をパラメーターとして受け取ることができます。テキストを太字または斜体にするための値など。ここでは、Markdown テキストを操作する方法の C# の例をいくつか見ていきます。

C# のマークダウンテキスト

C# ライブラリを使用すると、MD ファイルをプログラムで編集して、ドキュメントの構造と内容を変更できます。新しい Markdown ドキュメントをゼロから作成し、それにテキストを追加する方法を見てみましょう。

Markdown テキストを作成する 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;

    var header = mdf.AtxHeading("How to create Markdown Text in C#?", 2);

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

    // Add the  headers to the Markdown syntax tree
    md.AppendChild(header);

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

    // Add texts to the paragraph
    paragraph.AppendChild(mdf.Text("First, add an Aspose.HTML for .NET library reference to your C# project."));

    // Add a space after the first sentence in the paragraph through a special WhiteSpace node
    paragraph.AppendChild(mdf.Whitespace());

    paragraph.AppendChild(mdf.Text("Then create the Markdown Syntax Tree and use the SyntaxFactory property to get a syntax factory to create new elements."));

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

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

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

C# で Markdown テキストを作成する手順

Markdown テキストを作成するためのいくつかの簡単な手順を考えてみましょう。

MarkdownSyntaxTree() コンストラクターを使用して MarkdownSyntaxTree を作成します。
SyntaxFactory プロパティを使用して、Markdown 構文ツリーを作成するためのファクトリを取得します。
AtxHeading(string, int) コンストラクターを使用して新しいヘッダーを作成します。 MarkdownSyntaxFactory クラス。テキストコンテンツと見出しレベルで AtxHeadingSyntaxNode を作成します。
ヘッダーの後の空行に newLineTrivia 要素を作成します。 NewLineTrivia() コンストラクターを使用します。
SyntaxNodeCollection クラスの Add() メソッドを呼び出して、newLineTrivia ノードをヘッダー要素に追加します。
すべてのヘッダーノードが 1 つの要素に集められたら、それをドキュメントの構文ツリーに追加します。
SyntaxFactory の Paragraph() コンストラクターを使用して、新しい空の段落ノードを作成します。
Text() コンストラクターを使用して、段落のテキストノードを作成します。
Whitespace() コンストラクターを使用して、段落内のテキストノード間にスペースを作成します。 .
MarkdownSyntaxNode クラスの AppendChild() メソッドを呼び出して、テキストノードと空白を追加します。段落に。
すべての段落ノードが 1 つの要素に集められたら、それをドキュメント構文ツリーに追加します。 MarkdownSyntaxNode クラスの AppendChild() メソッドを呼び出します。

C# で Markdown Blockquote を作成する

次の C# コード例は、Markdown blockquote を作成する方法を示しています。

Markdown blockquote を追加する C# コード

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

    // Create a Markdown syntax factory
    var mdf = markdown.SyntaxFactory;

    // Create a blockQuote object
    var blockQuote = mdf.BlockQuote();

    // Add a leading trivia token blockquote
    blockQuote.GetLinesLeadingTrivia().Add(mdf.Token(SourceText.From("> ")));

    // Create a paragraph with text content 
    var paragraph = mdf.Paragraph();
    paragraph.AppendChild(mdf.Text("For blockquote creation, you should put a sign `>` before the first line of a hard-wrapped paragraph.."));

    // Add paragraph into blockQuote
    blockQuote.AppendChild(paragraph);

    // Add blockQuote object into MD document
    markdown.AppendChild(blockQuote);

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

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

ドキュメンテーション

Aspose.HTML API の詳細については、ドキュメントガイドをご覧ください。 Markdown は、プレーンテキストを書式設定できるシンプルなマークアップ言語です。 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 からインストールします。