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


よくある質問

1. C# で Markdown を作成、解析、編集するにはどうすればよいですか?

Aspose.HTML Library for .NET は、他のソフトウェアに依存しない Markdown ドキュメントを操作するためのスタンドアロン ソリューションです。 C# ライブラリをインストールし、ライブラリ参照を C# プロジェクトに追加して、Markdown ドキュメントをプログラムで操作します。

2. なぜマークダウンはこれほど人気があるのでしょうか?

Markdown は、その多用途性により、ライター、開発者、コンテンツ作成者の間で非常に人気があります。 その利点には、学習と使用が簡単な構文、移植性、柔軟性、読みやすさ、使いやすさが含まれます。 Markdown はシンプルで直感的で、HTML、PDF、またはその他の形式に変換できます。

3. Linux、Mac OS、Android、または iOS で Markdown ファイルを操作できますか?

Windows、Mac OS、Linux、Android、または iOS を使用しているかどうかに関係なく、どのオペレーティング システムでも Markdown ドキュメントを操作できます。

4. Aspose.HTML C# ライブラリで処理できるファイル フォーマットは?

C# で作成、開く、解析、編集、保存、または変換できるいくつかのファイル形式がサポートされています。これらは、HTML、XHTML、MHTML、および 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 からインストールします。