So erstellen Sie Markdown-Listen in C#

Die Bibliothek Aspose.HTML for .NET ist eine eigenständige Lösung, mit der Sie Markdown-Dateien analysieren und bearbeiten können, ohne andere Software zu verwenden. Sie können ein Markdown-Dokument von Grund auf neu erstellen, aus einer lokalen Datei öffnen und bearbeiten, indem Sie neue Elemente einfügen, den Inhalt bestehender Knoten entfernen oder bearbeiten. Markdown unterstützt geordnete (nummerierte) und ungeordnete (Aufzählungszeichen) Listen. In diesem Artikel erfahren Sie, wie Sie Listen in Markdown mithilfe der C#-Bibliothek hinzufügen. Verwenden Sie die Aspose.Html.Toolkit.Markdown.Syntax und Aspose.Html.Toolkit.Markdown.Parser Namespaces, um vollständiges Markdown-Parsing und MD-Syntaxbaumverwaltung basierend auf der GitHub Flavored Markdown (GFM)-Spezifikation bereitzustellen .


Erstellen Sie eine geordnete Markdown-Liste in C#

Mit der C#-Bibliothek können Sie MD-Dateien programmgesteuert bearbeiten – die Dokumentstruktur und den Inhalt ändern. Sehen wir uns an, wie Sie ein neues Markdown-Dokument von Grund auf neu erstellen und ihm eine geordnete Markdown-Liste hinzufügen.

C#-Code zum Erstellen einer geordneten Markdown-Liste

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

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

    // Create a new empty odered list node
    var orderedList = mdf.OrderedList();

    // Create and add to the odered list a li1 item with the marker “1”
    var li1 = mdf.OrderedListItem(1);
    orderedList.AppendChild(li1);

    // Create a paragraph with text content and add it to the li1 item
    var paragraph = mdf.Paragraph();

    var heading = mdf.AtxHeading("The first element in the Markdown ordered list is the level 3 heading.", 3);
    paragraph.AppendChild(heading);
    li1.AppendChild(paragraph);

    //Create and add to the odered list a li2 item with the marker “2”
    var li2 = mdf.OrderedListItem(2);
    orderedList.AppendChild(li2);

    // Create a strong emphasis with text content and add it to the li2 item
    var bold = mdf.Emphasis(Emphasis.Strong);

    bold.AppendChild(mdf.Text("The second item in the Markdown ordered list is in bold."));
    li2.AppendChild(bold);

    // Add orderedList to MD syntax tree
    md.AppendChild(orderedList);

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

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



Schritte zum Erstellen einer geordneten Markdown-Liste in C#

Hier sind ein paar einfache Schritte zum Erstellen einer geordneten Markdown-Liste:

  1. Erstellen Sie den MarkdownSyntaxTree mit dem Konstruktor MarkdownSyntaxTree().
  2. Verwenden Sie die Eigenschaft SyntaxFactory, um die Factory zum Erstellen des Markdown-Syntaxbaums abzurufen.
  3. Erstellen Sie mithilfe des Konstruktors OderedList() in SyntaxFactory einen neuen OrderedList-Knoten.
  4. Verwenden Sie den Konstruktor OrderedListItem() zum Erstellen neuer Instanzen der ListItemSyntaxNode-Klasse mit einem Markierung für geordnete Listenelemente.
  5. Rufen Sie die Methode AppendChild() der MarkdownSyntaxNode-Klasse auf, um geordnete Listenelemente hinzuzufügen der orderedList-Knoten.
  6. Nachdem alle Elemente mit ihrem Inhalt in einem einzelnen orderedList-Element gesammelt wurden, fügen Sie es dem Dokumentensyntaxbaum hinzu.

Ungeordnete Markdown-Liste in C# erstellen

Das folgende C#-Codebeispiel zeigt, wie eine ungeordnete Liste zu einer MD-Datei hinzugefügt wird:

C#-Code zum Hinzufügen einer ungeordneten Liste zur MD-Datei

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

    // Create a Markdown syntax factoty
    var mdf = md.SyntaxFactory;

    // Create a new empty unodered list node
    var unorderedList = mdf.UnorderedList();

    // Create and add to the unodered list a li1 element with the marker “-”
    var li1 = mdf.UnorderedListItem("-");
    unorderedList.AppendChild(li1);

    // Create a paragraph with text content and add it to the li1 item:
    var paragraph = mdf.Paragraph();
    paragraph.AppendChild(mdf.Text("The first item of the unordered Markdown list."));
    li1.AppendChild(paragraph);

    // Create and add to the unodered list a li2 element with the marker “-”
    var li2 = mdf.UnorderedListItem("-");
    unorderedList.AppendChild(li2);

    // Create a paragraph with text content and add it to the li2 item:
    var paragraph2 = mdf.Paragraph();
    paragraph2.AppendChild(mdf.Text("The second item of the unordered Markdown list."));
    li2.AppendChild(paragraph2);

    // Add unorderedList to MD syntax tree
    md.AppendChild(unorderedList);

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

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

Dokumentation

Um mehr über die Aspose.HTML-API zu erfahren, besuchen Sie bitte unseren Dokumentation -Leitfaden. Markdown ist eine einfache Auszeichnungssprache, mit der Sie einfachen Text formatieren können. Der Dokumentationsartikel Markdown-Syntax enthält Informationen zu den wichtigsten Markdown-Elementen, Details und Beispielen der Markdown-Syntax.


Erste Schritte mit der Aspose.HTML for .NET API

Es gibt mehrere Möglichkeiten, die Bibliothek Aspose.HTML for .NET auf Ihrem System zu installieren:

  1. Installieren Sie ein NuGet-Paket mithilfe der NuGet Package Manager-GUI.
  2. Installieren Sie ein NuGet-Paket mithilfe der Paket-Manager-Konsole.
  3. Installieren Sie Aspose.HTML for .NET über MSI.

Diese Bibliothek unterstützt das Parsen von HTML5, CSS3, SVG und HTML Canvas, um ein Document Object Model (DOM) basierend auf dem WHATWG DOM-Standard zu erstellen. Aspose.HTML for .NET ist vollständig in C# geschrieben und kann verwendet werden, um jede Art von 32-Bit- oder 64-Bit-.NET-Anwendung zu erstellen, einschließlich ASP.NET, WCF, WinForms und .NET Core. Stellen Sie vor dem Ausführen des Beispielcodes für die .NET-Konvertierung sicher, dass Sie über ein Betriebssystem wie Microsoft Windows oder ein mit .NET Framework oder .NET Standard kompatibles Betriebssystem und eine Entwicklungsumgebung wie Microsoft Visual Studio verfügen. Weitere Einzelheiten zur Installation der C#-Bibliothek und zu den Systemanforderungen finden Sie in der Aspose.HTML-Dokumentation.


Systemanforderungen

Unsere APIs werden auf allen wichtigen Plattformen und Betriebssystemen unterstützt. Bevor Sie den Code ausführen, stellen Sie bitte sicher, dass die folgenden Voraussetzungen auf Ihrem System erfüllt sind.

  • Microsoft Windows oder ein kompatibles Betriebssystem mit .NET Framework, .NET Core, Windows Azure, Mono oder Xamarin-Plattformen.
  • Entwicklungsumgebung wie Microsoft Visual Studio.
  • Aspose.HTML for .NET-DLL, auf die in Ihrem Projekt verwiesen wird – Installieren Sie von NuGet mithilfe der Download-Schaltfläche oben.