So funktioniert das Zusammenführen von Markdown in C#

Aspose.HTML for .NET führt Markdown in einem zweistufigen C#-Workflow zusammen. Converter.ConvertMarkdown() konvertiert jede .md-Quelldatei in ein HTMLDocument. Anschließend schreibt HtmlRenderer die konvertierten Dokumente in der angegebenen Reihenfolge an ein gemeinsames Ausgabegerät. Das Ergebnis ist ein PDF-, XPS-, DOCX- oder TIFF-Dokument und keine zusammengefügte, editierbare Markdown-Datei.


Markdown in C# zusammenführen und interaktives Beispiel

Mit dem interaktiven Beispiel können Sie die Reihenfolge der Quellen festlegen und einen passenden C#-Workflow erzeugen. Fügen Sie die Markdown-Dateien in der gewünschten Reihenfolge hinzu und wählen Sie PDF, XPS, DOCX oder TIFF. Das Code-Panel aktualisiert die Dateinamen, das Rendering-Gerät und die Dateierweiterung, sobald sich die Auswahl ändert. Sie können den konfigurierten Vorgang außerdem online ausführen, um das Ergebnis zu prüfen.

Workflow zum Zusammenführen von Markdown

Im Beispiel ist PDF standardmäßig ausgewählt. Derselbe zweistufige Workflow gilt für die anderen gerätebasierten Ausgaben des Widgets:

  1. Rufen Sie Converter.ConvertMarkdown() für jede Quelldatei auf, um ein HTMLDocument zu erstellen.
  2. Halten Sie die erzeugten Dokumente in der Reihenfolge, in der ihre gerenderten Seiten erscheinen sollen.
  3. Erstellen Sie eine HtmlRenderer -Instanz.
  4. Erstellen Sie das Ausgabegerät, beispielsweise PdfDevice für PDF.
  5. Übergeben Sie das Gerät und alle konvertierten Dokumente an HtmlRenderer.Render().

Ausgabeformat für den Markdown-Merger auswählen

  • PDF – ein Dokument mit festem Layout für Verteilung oder Druck erstellen.
  • XPS – die gerenderten Seiten in ein XPS-Dokument schreiben.
  • DOCX – ein Dokument für Microsoft Word oder einen anderen kompatiblen Editor erstellen.
  • TIFF – die zusammengeführten Seiten als Rasterbild rendern.

Der generierte C#-Code wählt je nach Zielformat PdfDevice, XpsDevice, DocDevice oder ImageDevice. Formatspezifische Einstellungen finden Sie unter Rendering Devices in C# .


Hinweise zum Zusammenführen von Markdown

  • Das Ergebnis ist eine gerenderte Ausgabe. Überschriften, Listen, Codeblöcke, Links und andere analysierte Markdown-Inhalte werden Teil der HTML-Zwischendokumente. Die ursprünglichen .md-Dateien werden nicht direkt aneinandergefügt.
  • Die Eingabereihenfolge bestimmt die Ausgabereihenfolge. Ordnen Sie die Dateien im Widget an oder übergeben Sie die konvertierten HTMLDocument-Objekte in der gewünschten Reihenfolge an Render().
  • Referenzierte Ressourcen müssen verfügbar bleiben. Relative Bilder und andere verknüpfte Ressourcen benötigen auflösbare Speicherorte, wenn das HTML-Zwischendokument gerendert wird.
  • Ausgabeeinstellungen sind gerätespezifisch. Seitengröße, Ränder, Auflösung und andere Optionen gehören zum gewählten Ausgabegerät und dessen Rendering-Optionen, nicht zum Markdown-Parser.

Aspose.HTML for .NET installieren

Installieren Sie Aspose.HTML for .NET aus NuGet mit der .NET CLI:

dotnet add package Aspose.HTML

Alternativ können Sie die Benutzeroberfläche des NuGet-Paket-Managers verwenden oder Install-Package Aspose.HTML in der Paket-Manager-Konsole ausführen. Einzelheiten zur Einrichtung finden Sie in der Installationsanleitung . Mit einer temporären Lizenz können Sie die API ohne Einschränkungen der Evaluierung testen.


Häufige Fragen zum Markdown-Merger

1. Kann ich als Streams bereitgestelltes Markdown zusammenführen?

Ja. Verwenden Sie für jede Quelle die Überladung Converter.ConvertMarkdown(Stream, string) und geben Sie einen Basis-URI an, über den relative Links und Bilder aufgelöst werden. Die Methode gibt ein HTMLDocument zurück, das zusammen mit den anderen konvertierten Quellen an den Renderer übergeben werden kann.

2. Kann ich das konvertierte Markdown vor dem Rendern bearbeiten?

Ja. Converter.ConvertMarkdown() gibt ein HTMLDocument zurück. Die Anwendung kann dessen DOM daher prüfen oder ändern, bevor es an HtmlRenderer.Render() übergeben wird. So lassen sich beispielsweise Überschriften oder Trennzeichen ergänzen und Inhalte vereinheitlichen.

3. Können konvertiertes Markdown und ein vorhandenes HTML-Dokument dieselbe Ausgabe verwenden?

Ja. Nachdem die Markdown-Quellen in HTMLDocument-Objekte konvertiert wurden, können Sie diese zusammen mit einem vorhandenen HTMLDocument an denselben Aufruf von HtmlRenderer.Render() übergeben. Die Reihenfolge der Argumente bestimmt ihre Reihenfolge in der gerenderten Ausgabe.

4. Werden relative Bilder aus Markdown-Dateien in der Ausgabe angezeigt?

Die Bilder werden aufgenommen, wenn ihre Pfade aufgelöst werden können und die Ressourcen beim Rendern verfügbar sind. Bewahren Sie Quelldatei und zugehörige Ressourcen gemeinsam auf oder geben Sie Basisadressen an, die zu den richtigen Bilddateien führen.

5. Kann ich Seitengröße und Ränder der zusammengeführten PDF-Datei konfigurieren?

Ja. Erstellen Sie PdfRenderingOptions, konfigurieren Sie PageSetup und übergeben Sie die Optionen an PdfDevice. Die gewählten Seiteneinstellungen gelten dann, während alle konvertierten Markdown-Dokumente in dieselbe PDF-Datei gerendert werden.

Weitere Möglichkeiten zum Zusammenführen von Dateien

Wählen Sie ein anderes Quellformat oder kehren Sie zur Übersicht der Merger-Workflows zurück.