C# で Markdown を編集する方法
Aspose.HTML for .NET
ライブラリは、他のソフトウェアを使用せずに Markdown ファイルを編集できるスタンドアロン ソリューションです。新しい要素を挿入したり、既存のノードのコンテンツを削除または編集したりして、Markdown ドキュメントを変更できます。
Aspose.Html.Toolkit.Markdown.Syntax
名前空間には、Markdown 構文ツリー ベースを操作するためのクラスとメソッドが含まれています。 GitHub Flavored Markdown (GFM) 仕様について。
Aspose.Html.Toolkit.Markdown.Parser
名前空間には、完全な Markdown 解析を提供するクラスとメソッドが含まれていますとレンダリング。
Aspose.Html.Toolkit.Markdown.Extensions
名前空間には、Markdown 構文ツリー ベースを操作するためのクラスとメソッドが含まれています。 GFM 仕様の一部ではない仕様について。
実行したいドキュメントの編集には、MD ドキュメントの読み込み、編集、およびサポートされている形式での保存が含まれます。さまざまなシナリオになる可能性がありますが、いくつかの必要な手順で作成できます。
- 開くか、Markdown を作成します。
- Markdown を解析して構文ツリーを取得します。上記の名前空間のクラスとメソッドを使用して、Markdown 構文ツリーを編集します。
- 保存 MD または MD を必要なファイル形式に変換します。
C# で MD ファイルに要素を追加する方法
C# ライブラリを使用すると、MD ファイルをプログラムで編集して、ドキュメントの構造と内容を変更できます。次の C# コード例は、MD ドキュメントに新しい段落を追加する方法を示しています。
MD ファイルを編集する C# コード
// Specify the path to the source MD file
var input = @"C:\temp\document.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 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("New paragraph text.");
paragraphSyntaxNode.AppendChild(textSyntaxNode);
// Add the paragraph 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-add-paragraph.md");
// Save MD file
syntaxTree.Save(savePath);
C# で要素を作成して MD ドキュメントに追加する手順
既存の MD ドキュメントを編集する簡単な手順を検討してください。ドキュメントに新しいテキスト パラグラフが追加されます。
- ソース MD ファイルへのパスを指定し、 MarkdownParser() コンストラクターを使用して、MarkdownParser クラスの新しいインスタンスを初期化します。
- ParseFile() メソッドを呼び出して、Markdown を解析し、構文ツリーを取得します。 .
- SyntaxFactory プロパティを使用して、新しい要素を作成するための構文ファクトリを取得します。
- Paragraph() コンストラクターを使用して新しい段落を作成します。新しい段落のテキスト コンテンツを作成して追加します。
- InsertBefore() メソッドを使用して、構文の最初の要素の前に段落を追加します。木。
- 編集した MD ファイルを Save() メソッドで保存します。
C# で Markdown ヘッダーを編集する方法
MD ファイルの最初の要素 ( document.md ) を編集する方法を見てみましょう。ファイルの最初の要素は、レベル 3 のヘッダーです。編集済みのファイルは、リンクの後に見つかります – output-edit-header.md
MD ファイルを編集する C# コード
// Specify the path to the source MD file
var input = @"C:\temp\document.md";
// Create a MarkdownParser object
var parser = new MarkdownParser();
// Parse the MD document and get a syntax tree
var syntaxTree = parser.ParseFile(input);
// The first element of this document is AtxHeading
var heading = (AtxHeadingSyntaxNode)syntaxTree.FirstChild;
// Accumulate the text content from its elements
var sb = new StringBuilder();
while (heading.FirstChild != null)
{
sb.Append(heading.FirstChild);
// Remove accumulated first element from the tree
heading.RemoveChild(heading.FirstChild);
}
// Get a SyntaxFactory to create new elements
var syntaxFactory = syntaxTree.SyntaxFactory;
// Сreate a text node consisting of new and old text and add it as a child element of AtxHeading
var textSyntaxNode = syntaxFactory.Text("Some new text! " + sb);
// Add the new element to the document tree
heading.AppendChild(textSyntaxNode);
// Prepare a path for MD file saving
string savePath = Path.Combine(OutputDir, "output-edit-header.md");
// Save MD file
syntaxTree.Save(savePath);
ドキュメンテーション
Aspose.HTML API の詳細については、
ドキュメント
ガイドをご覧ください。
GitHub
リポジトリからサンプルをダウンロードできます。それらはオープンソースであり、独自のアプリケーションで自由に使用できます。
Markdown Syntax
ドキュメント記事では、主な Markdown 要素、詳細、および Markdown 構文の例に関する情報を提供しています。
Markdown は、プレーン テキストを書式設定できるシンプルなマークアップ言語です。 MD ファイルは、John Gruber によって提案および開発された Markdown 言語を使用します。 John Gruber は、可能な限り読みやすくすることを目標に、Markdown の書式設定構文を設計しました。マークダウンは、読みやすく、書きやすいスタイルで記述できるため、ドキュメントや readme ファイルの形式としてよく使用されます。さらに、MD ファイルを HTML、PDF、XPS、または画像に変換して、特定のタスクで他の形式を利用することもできます。
よくある質問
Aspose.HTML Library for .NET は、他のソフトウェアに依存しないスタンドアロンの MD 編集ソリューションです。 C# ライブラリをインストールし、ライブラリ参照を C# プロジェクトに追加して、MD ドキュメントをプログラムで編集および管理します。
Aspose.HTML for .NET API を使用して MD を編集する方法の詳細については、ドキュメントを参照してください。 機能に関する質問がある場合、見つかった問題がある場合、または新機能が必要な場合は、無料サポート フォーラムでディスカッションを開始してください。
MD ドキュメントは、Windows、Mac OS、Linux、Android、iOS のいずれを使用している場合でも、どのオペレーティング システムでも編集できます。
HTML、MHTML、Markdown など、C# で編集できるいくつかのファイル形式がサポートされています。
.NET HTML 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 ドキュメント を参照してください。