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

C# ライブラリを使用して、Markdown Inline Code または Markdown Code Block を作成します。

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 ドキュメントをゼロから作成し、それにインラインコードを追加する方法を見てみましょう。

MD ファイルにインラインコードを追加する C# コード

    // 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 インラインコードを作成する簡単な手順を検討してください。

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

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

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

Markdown コードブロックを追加する C# コード

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

Aspose.HTML for .NET のインストール

.NET CLI を使用して、NuGet から Aspose.HTML for .NET をインストールします。

dotnet add package Aspose.HTML

NuGet パッケージマネージャーの UI を使用するか、パッケージマネージャーコンソールで Install-Package Aspose.HTML を実行することもできます。セットアップの詳細はインストールガイドを参照してください。評価制限なしで API を試すには、一時ライセンスを申請できます。

システム要求

当社の API は、すべての主要なプラットフォームとオペレーティングシステムでサポートされています。コードを実行する前に、システムに次の前提条件があることを確認してください。

Microsoft Windows または .NET Framework、.NET Core、Windows Azure、Mono、または Xamarin プラットフォームと互換性のある OS。
Microsoft Visual Studio のような開発環境。
プロジェクトで参照される .NET DLL 用の Aspose.Html – 上記の [ダウンロード] ボタンを使用して NuGet からインストールします。