Skip to main content

XML-Elemente in Markdown

Einige DocBook-XML-Elemente werden bei der Veröffentlichung in Markdown auf besondere Weise behandelt. Dies kann auf spezifische Markdown-Anforderungen zurückzuführen sein oder darauf, dass es für diese Elemente keinen Markdown-Äquivalent gibt.

Warnmeldungen

Mahnungen (z. B. Tipps oder Vorsichtshinweise) mit Titeln sowie alle Hinweis- und Gefahren-Mahnungen werden als reguläre Markdown-Zitate gerendert. Hinweise, Warnungen und andere Mahnungen, die ein Äquivalent in Markdown haben, werden als solche gerendert.

260203_MD_Note_Regular.png

Ein normaler Hinweis

260203_MD_Note_Title.png

Ein Hinweis mit Titel, der als normales Markdown-Zitat angezeigt wird

Info-Elemente

Folgende Elemente info werden in der Markdown-Ausgabe unterstützt:

Anmerkung

Dies gilt für Infoelemente auf Publikationsebene.

  • abstract

  • copyright

  • subtitle

  • title

Diese Infoelemente werden als Markdown-Kopfzeilentabelle ausgegeben.

260203_MD_Info_Elements.png

Geordnete Listen

Die Einstellung des Nummerierungsstils (z. B. loweralpha oder lowerroman) wirkt sich nicht auf die Ausgabe von Markdown aus, da sie in Github Flavored Markdown nicht unterstützt werden. Stattdessen wird der vom Browser definierte Standardstil verwendet.

Inline-Elemente und -Stile

Viele Inline-Styles und XML-Elemente haben keine logischen Gegenstücke in Markdown. Sie werden daher als Klartext gerendert. Die nachstehende Liste ist nicht erschöpfend, listet jedoch einige der am häufigsten verwendeten Stile und Elemente auf, für die es kein Markdown-Äquivalent gibt.

  • Oberlinie (Stil)

  • guilabel

  • tag

  • bibliography und sybelements

Tabellen

Es gibt einige Einschränkungen in Markdown in Bezug auf Tabellen:

  • Tabellenfußzeilen werden in normale Tabellenzeilen umgewandelt.

  • Tabellentitel und -unterschriften werden unterhalb der Tabelle platziert, es sei denn, die Tabelle enthält Zellbereiche (zusammengeführte Zellen), in diesem Fall werden sie oberhalb der Tabelle platziert.

  • Breiten- und Ausrichtungsinformationen für Tabellen werden verworfen.

  • Eine Tabelle ohne Kopfzeile erhält automatisch eine leere Kopfzeile in der Markdown-Ausgabe, da die Markdown-Syntax eine Kopfzeile erfordert.

Video

Eingebetteter Videoinhalt wird in einen Link zur Video-URL umgewandelt