Markdown in AsciiDoc umwandeln

Migriere gängige Markdown-Strukturen in AsciiDoc-Quelltext für Antora, Asciidoctor und andere Dokumentationsabläufe. Prüfe Erweiterungen und Projektkonventionen nach der Umwandlung.

Markdown-Eingabe

259 Zeichen

AsciiDoc-Vorschau

Konvertierter Text
= Projektnotizen

Ein übersichtliches Dokument beginnt mit einer *klaren Struktur*.

== Darauf kommt es an

* Verständliche Überschriften
* Funktionierende Links
* Dateien, die sich weiterbearbeiten lassen

> Prüfe vor dem Download die gerenderte Vorschau.
Dateien werden in diesem Browser-Tab verarbeitet.

Markdown nach AsciiDoc übertragen

Beide Auszeichnungssprachen ähneln sich, besitzen aber unterschiedliche Erweiterungen und Feinheiten.

01

Markdown vorbereiten

Bereinige die Überschriftenhierarchie und prüfe Listen, Links, Tabellen und Codeblöcke.

02

AsciiDoc vergleichen

Kontrolliere besonders verschachtelte Listen, Tabellen, Bilder, IDs und nicht standardisierte Markdown-Erweiterungen.

03

Zielprojekt testen

Speichere die .adoc-Datei und baue sie mit derselben Asciidoctor- oder Antora-Konfiguration wie im Projekt.

Dokumentationsquelle

Gängige Strukturen in AsciiDoc-Syntax

Die Ausgabe dient als Ausgangspunkt für ein AsciiDoc-Projekt.

GliederungÜberschriften und Absätze werden in entsprechende AsciiDoc-Strukturen übertragen.
Listen und CodeGängige Listen, Zitate und Codeblöcke erhalten passende Auszeichnungen.
Links und TabellenUnterstützte Links und einfache Tabellen werden in AsciiDoc-Syntax ausgegeben.
Geeignet für

Technische Inhalte in ein AsciiDoc-Projekt bringen

Antora-Dokumentation

Nutze bestehende Markdown-Inhalte als Grundlage für neue Moduldateien.

Asciidoctor-Pipelines

Bereite Quelldateien für HTML-, PDF- oder EPUB-Builds vor.

Projektstandardisierung

Überführe README- oder Handbuchtexte in die im Team vereinbarte Syntax.

Häufige Fragen

Häufige Fragen

Ist die Ausgabe sofort in Antora verwendbar?

Die Grundstruktur ist vorbereitet. Prüfe anschließend Seitentitel, Attribute, Includes, xrefs und die Konventionen deines Antora-Projekts.

Werden Codeblöcke übernommen?

Gängige, mit Backticks oder Tilden eingefasste Codeblöcke werden in eine passende AsciiDoc-Darstellung übertragen. Prüfe Sprachangabe und Optionen im Zielrenderer.

Ist die Umwandlung verlustfrei?

Nein. Nicht jede Markdown-Erweiterung besitzt eine eindeutige AsciiDoc-Entsprechung und umgekehrt.