Mit diesem Tool lässt sich Markdown in AsciiDoc umwandeln, und zwar in Asciidoctor-Syntax: Dokumenttitel, ==-Abschnitte, [source,lang]-Blöcke, |===-Tabellen, NOTE- und WARNING-Admonitions sowie Fußnoten. Markdown einfügen und den .adoc-Text kopieren.
Zuletzt aktualisiert:
So funktioniert’s
Markdown einfügen
Dokumentation einfügen, eine .md-Datei öffnen oder das Beispiel ausprobieren.
Kopfbereich anpassen
Mit „Erste H1 ist der Titel“ den Dokumenttitel setzen, per „Inhaltsverzeichnis“ :toc: ergänzen und Roh-HTML durchreichen oder entfernen.
Als .adoc speichern
Die Datei für Asciidoctor oder Antora herunterladen – auch GitHub stellt .adoc-Dateien dar.
Funktionen
Passende Admonitions
GitHub-Alerts lassen sich eins zu eins abbilden: [!TIP] wird zu einem [TIP]-Block, [!CAUTION] zu einem [CAUTION]-Block.
Listen mit Inhalt
Codeblöcke in Listeneinträgen werden per +-Fortsetzung angehängt, damit die Nummerierung nicht abreißt.
Tabellen mit Ausrichtung
Spaltenausrichtung und Kopfzeile stehen in einer Zeile wie [cols="<,^,>",options="header"].
Constrained und unconstrained
Grenzt Fett- oder Kursivschrift direkt an Buchstaben, werden doppelte Zeichen wie **…** gesetzt, die AsciiDoc innerhalb von Wörtern verlangt.
Grenzen & Datenschutz
Dateien dürfen bis zu 10 MB groß sein. Ab 256 KB erfolgt die Umwandlung in einem Web Worker, die Seite bleibt also bedienbar. Es wird nichts hochgeladen: Alles läuft im Browser, und „Von URL öffnen“ ruft die Datei direkt von der eingegebenen Adresse ab.
Gut zu wissen
Text, der in AsciiDoc eine Formatierung auslösen würde – die Zeichen * _ ` # ^ ~, Attributverweise in geschweiften Klammern oder typografische Ersetzungen wie (C) –, wird maskiert. Roh-HTML wird als Passthrough-Block übernommen, sofern es nicht entfernt werden soll; Passthrough wirkt allerdings nur mit dem HTML-Backend. Den Rückweg bietet AsciiDoc in Markdown.
Mehr zum Datenschutz auf der Datenschutzseite.
Häufige Fragen
Wie wird Markdown zu AsciiDoc?
Markdown einfügen und das Ergebnis kopieren oder als .adoc-Datei herunterladen.
Warum wird die erste Überschrift zu = Titel?
In AsciiDoc ist die Überschrift der Ebene 0 der Dokumenttitel. Wer alle Überschriften als Abschnitte behalten möchte, schaltet die Option aus.
Was passiert bei Wortteilen wie „Haupt**bahnhof**“?
Weil die Hervorhebung mitten im Wort beginnt, schreibt der Konverter die unconstrained Form mit doppelten Sternchen. So wird nur der gewünschte Teil fett.
Werden Fußnoten unterstützt?
Ja, als footnote:[…]-Makros direkt an der Stelle des Verweises.
Wie sieht es mit Formeln aus?
Sie werden zu latexmath:[…] bzw. [latexmath]-Blöcken. In Asciidoctor dafür das Attribut stem aktivieren.
Geht es auch zurück zu Markdown?
Ja, AsciiDoc in Markdown ist über dem Ergebnis verlinkt.