Markdown vorbereiten
Bereinige die Überschriftenhierarchie und prüfe Listen, Links, Tabellen und Codeblöcke.
Migriere gängige Markdown-Strukturen in AsciiDoc-Quelltext für Antora, Asciidoctor und andere Dokumentationsabläufe. Prüfe Erweiterungen und Projektkonventionen nach der Umwandlung.
= 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.
Beide Auszeichnungssprachen ähneln sich, besitzen aber unterschiedliche Erweiterungen und Feinheiten.
Bereinige die Überschriftenhierarchie und prüfe Listen, Links, Tabellen und Codeblöcke.
Kontrolliere besonders verschachtelte Listen, Tabellen, Bilder, IDs und nicht standardisierte Markdown-Erweiterungen.
Speichere die .adoc-Datei und baue sie mit derselben Asciidoctor- oder Antora-Konfiguration wie im Projekt.
Die Ausgabe dient als Ausgangspunkt für ein AsciiDoc-Projekt.
Nutze bestehende Markdown-Inhalte als Grundlage für neue Moduldateien.
Bereite Quelldateien für HTML-, PDF- oder EPUB-Builds vor.
Überführe README- oder Handbuchtexte in die im Team vereinbarte Syntax.
Die Grundstruktur ist vorbereitet. Prüfe anschließend Seitentitel, Attribute, Includes, xrefs und die Konventionen deines Antora-Projekts.
Gängige, mit Backticks oder Tilden eingefasste Codeblöcke werden in eine passende AsciiDoc-Darstellung übertragen. Prüfe Sprachangabe und Optionen im Zielrenderer.
Nein. Nicht jede Markdown-Erweiterung besitzt eine eindeutige AsciiDoc-Entsprechung und umgekehrt.