C# での Markdown Text と Markdown Blockquote

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

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

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

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

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

// 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 テキストを作成するためのいくつかの簡単な手順を考えてみましょう。

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

C# で Markdown Blockquote を作成する

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

// 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 構文の例に関する情報を提供しています。

よくある質問

.NET HTML 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 からインストールします。