C# のマークダウン コード ブロック

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# で Markdown インライン コードまたは Markdown コード ブロックを作成する場合、CodeSpan または FencedCodeBlock 要素を複数のノード (テキスト ノード、テキスト ノード間のスペース、ノードの後の空行など) から組み立てる必要があるという特徴があります。
Markdown ドキュメントをゼロから作成し、それにインライン コードを追加する方法を見てみましょう。

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

    // Use the SyntaxFactory property to get the factory for creating the Markdown syntax tree
    var mdf = markdown.SyntaxFactory;

    // Create an empty codeSpan node
    var codeSpan = mdf.CodeSpan();

    // Create text content for the codeSpan
    codeSpan.AppendChild(mdf.Text("Source code text"));

    // Add codeSpan to MD document
    markdown.AppendChild(codeSpan);

    // Add a space after the code node through a special WhiteSpace node
    markdown.AppendChild(mdf.Whitespace());

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

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

C# で Markdown コードを作成する手順

インライン コードはコンポーネント ノードからアセンブルする必要があることを思い出してください。 Markdown インライン コードを作成する簡単な手順を検討してください。

1. SyntaxFactory の CodeSpan() コンストラクターを使用して、新しい空の CodeSpan ノードを作成します。
2. Text() コンストラクターを使用して、CodeSpan のテキスト ノードを作成します。
3. MarkdownSyntaxNode クラスの AppendChild() メソッドを呼び出して、テキスト ノードをCodeSpan 要素。
4. AppendChild() メソッドを使用して、作成したコード ブロックをドキュメント構文ツリーに追加します。
5. Whitespace() コンストラクターを使用して、インライン コードの後に​​スペースを作成します。

C# で MD ファイルに Markdown コード ブロックを追加する

次の C# コード例は、Markdown コード ブロックを MD ドキュメントに追加する方法を示しています。

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

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

    // Create a start token and an end token that will frame a code block
    var startToken = mdf.Token(SourceText.From("```\r\n"));
    var endToken = mdf.Token(SourceText.From("\r\n```"));

    // Create a fenced code element
    var fencedCodeSpan = mdf.FencedCodeBlock(startToken, null, endToken);

    // Create text content for the fenced code element
    fencedCodeSpan.AppendChild(mdf.Text("Source code text"));

    //Add the fenced code element to MD file
    markdown.AppendChild(fencedCodeSpan);
            
    // Prepare a path for MD file saving 
    string savePath = Path.Combine(OutputDir, "markdown-code-block.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 からインストールします。