Konvertieren eines Dokuments in Markdown
Markdown ist ein beliebtes Format zum Markieren von Text und wird weiter konvertiert in HTML, PDF, DOCX, oder andere Formate. Viele Entwickler wählen dieses Format zum Schreiben von Dokumentationen, zum Vorbereiten von Artikeln für die Veröffentlichung in Blogs, zum Beschreiben von Projekten usw.
Markdown ist so beliebt, weil es einfach ist, mit diesem Format zu arbeiten und es ganz einfach in andere Formate konvertiert werden kann. Aus diesem Grund bietet Aspose.Words die Möglichkeit, ein Dokument von jedes unterstützte Ladeformat nach Markdown und umgekehrt zu konvertieren – Aspose.Words unterstützt auch das beliebteste formate speichern.
Jetzt wird die Funktionalität für die Arbeit mit dem Markdown -Format aktiv weiterentwickelt, um Ihnen mehr Möglichkeiten für die bequeme und komfortable Arbeit mit Dokumenten zu bieten.
Konvertieren eines Dokuments in Markdown
Um ein Dokument in Markdown zu konvertieren, müssen Sie nur ein Dokument in einem beliebigen unterstützten Format laden oder programmgesteuert ein neues erstellen. Dann müssen Sie das Dokument im Format Markdown speichern.
Das folgende Codebeispiel zeigt, wie DOCX in Markdown konvertiert wird:
Geben Sie beim Konvertieren in Markdown Speicheroptionen an
Aspose.Words bietet die Möglichkeit, die Klasse MarkdownSaveOptions zu verwenden, um mit erweiterten Optionen zu arbeiten, wenn ein Dokument im Format Markdown gespeichert wird. Zusätzlich zu anderen Eigenschaften, die erben oder überladen, wurde auch eine Reihe von Eigenschaften hinzugefügt, die spezifisch für das Markdown-Format sind. Zum Beispiel die Eigenschaft TableContentAlignment, um die Ausrichtung von Inhalten in Tabellen zu steuern, oder ImageSavingCallback und ImagesFolder, um zu steuern, wie Bilder beim Konvertieren eines Dokuments in das Format Markdown gespeichert werden.
Unterstützte Markdown Funktionen
Aspose.Words unterstützt derzeit die folgenden Markdown -Funktionen, die größtenteils der CommonMark
-Spezifikation in Aspose.Words API folgen und als geeignete Stile oder direkte Formatierung dargestellt werden:
- Überschriften sind Absätze mit Heading 1 – Heading 6 Stilen
- Blockzitate sind Absätze mit “Zitat” im Stilnamen
- IndentedCode sind Absätze mit “IndentedCode” im Stilnamen
- FencedCode sind Absätze mit “FencedCode” im Stilnamen
- InlineCode werden mit “InlineCode” im
Font
-Stilnamen ausgeführt - Horizontale Regeln sind Absätze mit der Form
HorizontalRule
- Kräftige Betonung
- Kursive Hervorhebung
- StrikeThrough Formatierung
- Listen sind nummerierte oder mit Aufzählungszeichen versehene Absätze
- Tabellen werden mit der Klasse
Table
dargestellt - Links werden als
FieldHyperlink
-Klasse dargestellt
Das folgende Beispiel zeigt, wie Sie ein Dokument mit einigen Stilen erstellen und unter Markdown speichern:
Das Ergebnis dieses Codebeispiels ist unten gezeigt.
Nützliche Tipps
Es gibt verschiedene Nuancen und interessante Fälle, nachdem Sie gelernt haben, dass Sie flexibler und bequemer mit Markdown -Dateien arbeiten können. Zum Beispiel gibt es die Möglichkeit zu verwenden:
- SetextHeading, mit dem Sie mehrzeilige Überschriften in Markdown erstellen können, während reguläre Überschriften in Markdown nur einzeilig sein können. SetextHeading basiert auf einem Stil “Überschrift N” und seine Ebene kann nur 1 oder 2 sein. Wenn N in “Überschrift N” größer oder gleich 2 ist, dann basiert die entsprechende SetextHeading auf “Heading 2”, ansonsten auf “Heading 1”.
- Verschiedene Markierungen für die erste Ebene von Aufzählungslisten ("-", “+” oder “*”, die Standardmarkierung ist “-”.) und verschiedene Arten der Nummerierung für geordnete Listen ("." oder “)”, die Standardmarkierung ist “.").