Konvertieren Sie HTML Markdown C#

Markdown ist eine Auszeichnungssprache mit einfachen Symbolen, die Überschriften, Fettdruck, Kursivschrift, Unterstreichungen und vieles mehr kennzeichnen. Es ist einfach zu lernen und zu schreiben, daher werden hauptsächlich Online Dokumentationen und Readme Dateien mit dem Markdown geschrieben. Sie können Markdown in wenigen Schritten einfach in eine HTML-Webseite konvertieren. Ebenso ist die HTML zu Markdown-Konvertierung ebenfalls ein nützliches Feature, das wir hier mit der C#-Sprache untersuchen werden.

HTML und Markdown-Konverter – API-Installation

Sie können die Dateien im HTML-Webseiten und Markdown-Format mithilfe der Programmiersprache C# konvertieren. Sie müssen die API Aspose.HTML for .NET installieren, um diese Dateiformate zu bearbeiten und zu konvertieren. Sie können die API entweder mit dem folgenden Installationsbefehl aus der Galerie NuGet installieren oder die DLL-Datei aus dem Abschnitt Downloads herunterladen, um sie Ihrem Projekt als Referenz hinzuzufügen.

PM> Install-Package Aspose.Html

Bisher können Sie die API innerhalb weniger Minuten konfigurieren. Lassen Sie uns nun verschiedene mögliche Szenarien durchgehen:

Konvertieren Sie HTML-Webseiten programmgesteuert in C# in Markdown (.md)

Sie können HTML-Webseiten in Ihren .NET-basierten Anwendungen in Markdown konvertieren. Diese beliebte Konvertierungsfunktion wird so unterstützt, dass Sie nur die API aufrufen müssen, ohne sich mit den Details der zugrunde liegenden Dateiformate befassen zu müssen. Daher müssen Sie die folgenden Schritte für die HTML-Webseitenkonvertierung ausführen:

  1. Erstellen Sie eine HTML-Datei oder laden Sie die vorhandene Eingabedatei
  2. Rufen Sie die Methode ConvertHTML mit dem Objekt MarkdownSaveOptions auf
  3. Speichern Sie die Markdown-Ausgabedatei (.md).

Der folgende Code zeigt, wie Sie eine HTML-Webseite mit C# in Markdown konvertieren:

// Bereiten Sie einen HTML-Code vor und speichern Sie ihn in der Datei.
var code = "<h1>Header 1</h1>" +
            "<h2>Header 2</h2>" +
            "<p>Hello World!!</p>";
System.IO.File.WriteAllText(dataDir + "document.html", code);

// Rufen Sie die ConvertHTML-Methode auf, um HTML in Markdown zu konvertieren.
Aspose.Html.Converters.Converter.ConvertHTML(dataDir + "document.html", new Aspose.Html.Saving.MarkdownSaveOptions(), dataDir + "output.md");

Konvertieren Sie eine HTML-Webseite in Markdown MD (.md) mit zusätzlichen Optionen in C#

Wir haben bereits den einfachen und grundlegenden Anwendungsfall der Konvertierung von HTML in die Markdown-Notation kennengelernt. Gehen wir noch einen Schritt weiter, wo wir den Konvertierungsprozess steuern werden. Stellen Sie sich ein Szenario vor, in dem eine HTML-Datei viele irrelevante Daten enthält, wir aber nur den Inhalt in Absatz oder Hyperlink-Tags konvertieren müssen. Wir werden die folgenden Schritte ausführen, um diese Funktion zu verstehen und auszuprobieren:

  1. Laden Sie eine Eingabe-HTML-Datei
  2. Initialisieren Sie das Objekt MarkdownSaveOptions.
  3. Legen Sie die Flag-Variablen unter der Eigenschaft Features fest
  4. Speichern Sie die Markdown-Ausgabedatei

Der folgende Code basiert auf diesen Schritten, die zeigen, wie man eine HTML-Webseite in Markdown mit zusätzlichen Optionen mit C# konvertiert:

// Bereiten Sie einen HTML-Code vor und speichern Sie ihn in der Datei.
var code = "<h1>Header 1</h1>" +
            "<h2>Header 2</h2>" +
            "<p>Hello World!!</p>" +
            "<a href='aspose.com'>aspose</a>";
System.IO.File.WriteAllText(dataDir + "document.html", code);

// Erstellen Sie eine Instanz von SaveOptions und richten Sie die Regel ein: 
// - nur <a>und</a><p> <a>Elemente werden in Markdown umgewandelt.</a>
var options = new Aspose.Html.Saving.MarkdownSaveOptions();
options.Features = Aspose.Html.Saving.MarkdownFeatures.Link | Aspose.Html.Saving.MarkdownFeatures.AutomaticParagraph;

// Rufen Sie die ConvertHTML-Methode auf, um den HTML-Code in Markdown zu konvertieren.
Aspose.Html.Converters.Converter.ConvertHTML(dataDir + "document.html", options, dataDir + "output_options.md");

Konvertieren Sie Markdown (.md) programmgesteuert mit C# in eine HTML-Webseite

In einigen Szenarien müssen Sie möglicherweise HTML in die Markdown-Notation konvertieren. Beispielsweise werden einige Dokumentationsabschnitte in Webanwendungen und vielen anderen Anwendungsfällen verwendet. Mit den folgenden Schritten können Sie die Markdown-Datei ganz einfach in HTML konvertieren:

  1. Erstellen Sie eine Markdown-Datei (.md) oder laden Sie die Eingabedatei
  2. Speichern Sie die ausgegebene HTML-Datei mit der Methode ConvertMarkdown.

Der folgende Code zeigt, wie eine Markdown-Datei (.md) mithilfe der Programmiersprache C# in eine HTML-Webseite konvertiert wird:

// Bereiten Sie ein einfaches Markdown-Beispiel vor
var code = "### Hello World" +
            "\r\n" +
            "[visit applications](https://products.aspose.app/html/family)";
// Erstellen Sie eine Markdown-Datei
System.IO.File.WriteAllText(dataDir + "input_document.md", code);

// Konvertieren Sie Markdown in ein HTML Dokument
Aspose.Html.Converters.Converter.ConvertMarkdown(dataDir + "input_document.md", dataDir + "MarkdownToHTMLoutput.html");

Beispielprojekt und Beispieldateien herunterladen

Zur Demonstration der oben genannten Funktionen haben wir ein Beispielprojekt zusammengestellt, in dem Sie auch die Beispieldateien herunterladen können. Es ist eine Konsolenanwendung, die Sie ausprobieren können, um die Markdown und HTML-Interkonvertierungsfunktionen zu erkunden und zu verstehen. Sie können also die ZIP-Datei herunterladen oder das GitHub-Repository klonen, um die Funktionen zu testen.

Fazit

Kurz gesagt, wir haben die Konvertierung von HTML-Webpage und Markdown Dateien im Detail untersucht. Die API kann diese Dateien schnell und effizient mit einfachen API-Aufrufen konvertieren. Darüber hinaus können Sie weitere Funktionen kennenlernen, indem Sie Produktdokumentation und API-Referenzen besuchen. Falls Sie jedoch Bedenken haben, können Sie sich gerne über das kostenlose Support-Forum mit uns in Verbindung setzen.

Siehe auch