Zum Inhalt springen
100% lokal

AsciiDoc- und Markdown-Konverter

Konvertieren Sie AsciiDoc-Syntax in Markdown und umgekehrt direkt im Browser.

Eingabe
Ausgabe

AsciiDoc- und Markdown-Konverter

Fügen Sie AsciiDoc-Code ein — eine README-Datei, eine Dokumentationsseite, ein aus einem Wiki exportiertes Fragment — und dieses Tool schreibt ihn als Markdown um. Überschriften (=, ==, bis ======) werden zu # bis ######. Fettdruck (*word*) wird zu **word**, während Kursivdruck (_word_) und Inline-Code (`word`) bereits die gleiche Syntax in beiden Formaten haben und unverändert durchgehen. link:url[text] und bare https://url[text] werden zu [text](url), image::url[alt] zu ![alt](url), ein [source,language]-Block in ---- wird zu einem eingezäunten Code-Block, und eine |=== Tabelle wird zu einer Markdown-Pipe-Tabelle mit einer Header-Trennzeile. NOTE-, TIP-, WARNING-, IMPORTANT- und CAUTION-Admonitions werden zu Blockquotes oder GitHub-Style-Alerts, und das Ganze funktioniert auch rückwärts, von Markdown zu AsciiDoc, über die Richtungsoption.

Die anderen Optionen gestalten die Details: Der Überschriftenstil wählt zwischen ATX (#) oder Setext (Unterstrich mit = oder -, nur für Ebenen eins und zwei — tiefere Überschriften fallen auf ATX zurück); das Admonition-Format wählt zwischen einfachter Blockquote oder GitHub-Alert-Block; der Aufzählungsstil wählt den Gedankenstrich oder das Sternchen für ungeordnete Listen; und das Speichern von Attributen als Front Matter wandelt AsciiDoc-Zeilen :name: value in einen YAML-Block um, statt sie zu löschen, was auch in die Rückrichtung gespiegelt wird.

Dies ist ein leichtgewichtiger, musterbasierter Konverter, kein vollständiger Parser, daher funktioniert er am besten mit den oben genannten Konstrukten. Geordnete Listen werden immer als "1." oder "." gerendert — Renderer nummerieren sequenziell unabhängig von den Ziffern der Markierung selbst, daher ist die Nummerierung nicht betroffen. Windows- und Unix-Zeilenumbrüche werden auf die gleiche Weise behandelt, und die Statistik meldet Zeilen rein, Zeilen raus und umgewandelte Elemente.

Alles läuft lokal in Ihrem Browser ab, während Sie tippen — nichts, was Sie einfügen, wird hochgeladen, protokolliert oder irgendwohin gesendet. Kopieren Sie das Ergebnis, laden Sie es als .txt-Datei herunter, oder geben Sie es zur weiteren Bearbeitung erneut in die Eingabe ein.

Häufige Fragen

Kann dieses Tool in beide Richtungen konvertieren — AsciiDoc zu Markdown und Markdown zu AsciiDoc?
Ja. Die Richtungsoption wechselt, welches Format gelesen und welches produziert wird, und durch das Umschalten wird die aktuelle Ausgabe auch zurück in die Eingabe verschoben, damit Sie in eine Richtung konvertieren und dann die Rundreise überprüfen können.
Warum werden geordnete Listen immer als "1." oder "." ausgegeben?
Sowohl Markdown- als auch AsciiDoc-Renderer nummerieren geordnete Listen sequenziell, unabhängig davon, welche Ziffer oder wie viele Punkte auf jeder Quellzeile stehen, daher wird das Schreiben jeder Markierung auf die gleiche Weise immer noch korrekt nummerierte Ausgabe ohne den Konverter erzeugt, der Zähler selbst nachverfolgen muss.
Was passiert mit AsciiDoc-Konstrukten, die dieses Tool nicht erkennt?
Alles außerhalb des unterstützten Satzes — Überschriften, Fettdruck, Links, Bilder, Listing-Blöcke, Einzeiler-Tabellen, Admonitions, Listen und :name: value-Attribute — wird als reiner Text belassen, anstatt es zu erraten, damit die Ausgabe vorhersehbar bleibt, anstatt unbekanntes Markup lautlos zu verderben.
Kann es verschachtelte oder mehrzeilige Tabellen konvertieren?
Es unterstützt die gängige kompakte Form, bei der jede Tabellenzeile zwischen |=== Trennzeichen (AsciiDoc) oder als Standard-Pipe-Tabelle mit Kopfzeilentrenner (Markdown) auf einer eigenen Zeile sitzt. AsciiDoc-Tabellen, die mit einer Zelle pro Zeile und Leerzeilen-Trennzeichen geschrieben wurden, werden nicht rekonstruiert.
Wird mein Dokument irgendwo hochgeladen?
Nein. Die Konvertierung läuft vollständig in Ihrem Browser — nichts, was Sie einfügen, verlässt jemals Ihr Gerät.