C# で Markdown 段落を作成する方法
Aspose.HTML for .NET
ライブラリは、他のソフトウェアを使用せずに Markdown ファイルを解析および操作できるスタンドアロン ソリューションです。 Markdown ドキュメントをゼロから作成したり、ローカル ファイルから開いたり、新しい要素を挿入したり、既存のノードのコンテンツを削除または編集したりして操作できます。
Aspose.Html.Toolkit.Markdown.Syntax
と
Aspose.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 段落を作成する簡単な手順を検討してください。
- SyntaxFactory の Paragraph() コンストラクターを使用して、新しい空の段落ノードを作成します。
- Text() コンストラクターを使用して、段落のテキスト ノードを作成します。
- MarkdownSyntaxNode クラスの AppendChild() メソッドを呼び出して、テキスト ノードと空白を追加します。段落に。
- Whitespace() コンストラクターを使用して、段落内のテキスト ノード間にスペースを作成します。 .
- パラグラフの後の空行に newLineTrivia 要素を作成して追加します。 NewLineTrivia() コンストラクターと Add() メソッドを使用します。
- すべての段落ノードが 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 は、他のソフトウェアに依存しない Markdown ドキュメントを操作するためのスタンドアロン ソリューションです。 C# ライブラリをインストールし、ライブラリ参照を C# プロジェクトに追加して、Markdown ドキュメントをプログラムで操作します。
Markdown は、その多用途性により、ライター、開発者、コンテンツ作成者の間で非常に人気があります。 その利点には、学習と使用が簡単な構文、移植性、柔軟性、読みやすさ、使いやすさが含まれます。 Markdown はシンプルで直感的で、HTML、PDF、またはその他の形式に変換できます。
Windows、Mac OS、Linux、Android、または iOS を使用しているかどうかに関係なく、どのオペレーティング システムでも Markdown ドキュメントを操作できます。
C# で作成、開く、解析、編集、保存、または変換できるいくつかのファイル形式がサポートされています。これらは、HTML、XHTML、MHTML、および Markdown 形式です。
Aspose.HTML for .NET API を使ってみる
Aspose.HTML ライブラリ for .NET をシステムにインストールするには、いくつかの方法があります。
- NuGet パッケージ マネージャー GUI を使用して NuGet パッケージ をインストールします。
- パッケージ マネージャー コンソールを使用して NuGet パッケージをインストールします。次のコマンド
PM> Install-Package Aspose.Html
を使用できます。 - 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 からインストールします。