# Markdown-⇄-AsciiDoc-Konverter

Bidirektionale Konvertierung zwischen GitHub-Flavored Markdown und AsciiDoc (das Standardformat von Antora, Red Hat und Asciidoctor): automatische Verschiebung der Überschriftenebenen (= ist in AD der Dokumenttitel), Umkehrung der Klammerreihenfolge bei Links, Code-Blöcke ⇄ [source], GFM-Tabellen ⇄ |===, Admonitions NOTE/TIP/WARNING, Task-Listen, Fußnoten, Anker und Querverweise, harte Zeilenumbrüche; Konstrukte ohne exakte Entsprechung erscheinen als Hinweise.

> Kanonische Seite: https://elysiatools.com/de/tools/markdown-asciidoc-converter

- **Kategorie:** Format Conversion

- **Schlagwörter:** markdown zu asciidoc, asciidoc zu markdown, antora-migration, asciidoctor-konvertierung, dokumentationskonverter

## Überblick

Der Konverter ist ein zeilenweiser Block-Parser plus Inline-Emphasis-Tokenizer, ohne Abhängigkeiten, in beide Richtungen. Kernregeln: MD #/## → AD ==/=== (außer bei Erhebung der ersten H1 zum Titel =); \[Text\](url) wird zu url\[Text\], URLs mit Klammern oder Unterstrichen werden in ++…++ eingepackt; \`\`\`-Zäune → \[source,lang\] + ----; GFM-Tabellen → |=== mit options="header" und der :----Ausrichtung im Colspec; >-Zitate → \[quote\]-Block mit \[quote, Autor\]; NOTE:/TIP:/IMPORTANT:/WARNING:/CAUTION: ⇄ GitHub-Alert > \[!NOTE\]; Task-Listen, Fußnoten, \[\[Anker\]\], <\>, harte Umbrüche und Trennlinien. Die Richtung AD→MD degradiert include::, Attribute {x} und Bedingungen zu HTML-Kommentaren mit Hinweis. Ein verlustfreies Hin-und-Her wird nicht versprochen — Ziel ist die Korrektheit einer einmaligen Migration.

## Eingaben

- **Konvertierungsrichtung** (select)
- **Quelldokument** (textarea): Paste your Markdown (or AsciiDoc when converting back)…
- **Erste H1 zum Dokumenttitel erheben** (checkbox)
- **Nicht abbildbare Auszeichnung sichtbar lassen** (checkbox)

## Wann verwenden

- Bei der Migration bestehender GitHub-Markdown-Dokumentationen zu Antora oder Asciidoctor.
- Beim Übertragen von AsciiDoc-Handbüchern in Git-Repositories, die reines Markdown voraussetzen.
- Für die schnelle Konvertierung einzelner technischer Artikel, Tabellen und Code-Snippets zwischen beiden Formaten.

## Funktionsweise

- Richtung auswählen: Markdown zu AsciiDoc (`md2ad`) oder AsciiDoc zu Markdown (`ad2md`).
- Quelldokument in das Textfeld einfügen und Optionen zur H1-Titel-Erhöhung sowie zur Behandlung nicht abbildbarer Konstrukte festlegen.
- Der Parser verarbeitet Blöcke, Listen, Links und Inline-Formatierungen und gibt den transformierten Text direkt aus.

## Anwendungsfälle

- Übernahme von Markdown-basierten Release Notes in ein AsciiDoc-geführtes Dokumentationssystem.
- Rückportierung von Antora-Handbuchkapiteln in GitHub-README-Dateien.
- Bereinigung und syntaktische Anpassung gemischter Dokumentationsbestände in Redaktions-Workflows.

## Häufig gestellte Fragen

### Wie werden Überschriften zwischen Markdown und AsciiDoc übersetzt?

Standardmäßig wird die erste Markdown-H1 (`#`) bei aktivierter Titel-Option zum AsciiDoc-Dokumenttitel (`=`) und Unterüberschriften verschieben sich entsprechend zu `==` oder `===`.

### Werden GitHub-Alerts und Admonitions unterstützt?

Ja, GitHub-Alerts wie `> [!NOTE]` oder `> **Note**` werden direkt in AsciiDoc-Hinweisblöcke wie `NOTE:` und umgekehrt umgewandelt.

### Was passiert mit Tabellenausrichtungen bei der Konvertierung?

GFM-Rohr-Tabellen werden in AsciiDoc-Tabellen (`|===`) inklusive Spaltenausrichtungen über `colspec` (`cols="..."`) und `options="header"` überführt.

### Wie werden AsciiDoc-Includes und Attribute in Markdown behandelt?

Direktiven wie `include::` oder `{attribute}` ohne direktes Markdown-Äquivalent werden als sichtbare HTML-Kommentare mit Hinweistext beibehalten.

### Gibt es Unterschiede bei der Syntax von Hyperlinks?

Ja, Markdown-Links im Format `[Text](URL)` werden automatisch in das AsciiDoc-Format `URL[Text]` umgewandelt, inklusive Sonderzeichen-Schutz.

## Ähnliche Tools

- [Markdown zu HTML Konverter](https://elysiatools.com/de/tools/markdown-to-html): Konvertiert Markdown-Text in HTML mit anpassbaren Formatierungsoptionen
- [Markdown zu Klartext](https://elysiatools.com/de/tools/markdown-to-plain-text): Markdown-formatierten Text in Klartext umwandeln, indem alle Markdown-Syntax und Formatierung entfernt wird
- [Figma iOS Android pt dp sp Responsive-Spezifikationskarte](https://elysiatools.com/de/tools/figma-ios-android-pt-dp-sp-responsive-design-spec-card): Rechnet Figma-px-Werte in die korrekten Plattform-Einheiten um und erzeugt eine Entwickler-Spec-Card: iOS-pt (@1x/@2x/@3x mit gerenderten px je Skalierung), Android-dp/sp (Render-Tabelle mdpi…xxxhdpi und Schriftskalierung), Web-rem/vw mit clamp()-Snippet; Prüfung der minimalen Touch-Ziele (44pt iOS / 48dp Android / 44px und 24px WCAG) samt Material-Fensterklassen und Tailwind-Breakpoints.
- [Hash-Algorithmus-Vergleich](https://elysiatools.com/de/tools/hash-algorithm-comparator): Hasht dieselbe Eingabe mit MD5, SHA-1, SHA-256, SHA-512, BLAKE2b und BLAKE3 und vergleicht sie: Ausgabelänge, Hex/Base64-Digest, Sicherheitsstatus (gebrochen/modern) und relatives Geschwindigkeits-Benchmark. Gut für Lehre, Algorithmuswahl und Prüfsummenkontrolle.
- [OKR- & KPI-Baum-Zerleger](https://elysiatools.com/de/tools/okr-tree-decomposer): Zerlegt ein Unternehmens-Objective in Abteilung → Team → Personal, mit Gewicht/Ziel/Ist pro Knoten; der gewichtete Fortschritt rollt nach oben. Visueller Baum + Markdown.
- [KI Bild zu Markdown](https://elysiatools.com/de/tools/ai-image-to-markdown): Text aus Bildern extrahieren und mit KI-Visionmodellen in Markdown-Format umwandeln
- [Serum-Anionenlücken-Rechner (AG)](https://elysiatools.com/de/tools/anion-gap-calculator): Berechnet die Serum-Anionenlücke AG = Na⁺ − Cl⁻ − HCO₃⁻ (mmol/L), optional mit K⁺-Formel und Albumin-Korrektur. Ein erhöhter AG (≈ >12) spricht für eine Akkumulation nicht gemessener Anionen (Laktat, Ketonkörper, Methanol/ethylenglykol, Salicylate, Niereninsuffizienz; Eselsbrücke GOLD-MARK). Eine metabolische Azidose mit normalem AG (8–12) ist hyperchlorämisch: Diarrhö, renale tubuläre Azidose, Infusion von Kochsalzlösung. Ein niedriger AG (<3–6) meist durch Hypoalbuminämie; auch Hyperkalzämie/Hypermagnesiämie, Lithium, IgG-Myelom (kationische Paraproteine), Bromid/Pseudohyperchlorämie. Bei Hypoalbuminämie Korrektur AG_corr = AG + 2.5×(4.0 − Albumin) verwenden. Quellen: Kraut CJASN 2007, Figge 1998, MDCalc. Mit Blutgasen und Klinik interpretieren. Keine medizinische Beratung.
- [Eingerückte Liste zu ASCII-Baum](https://elysiatools.com/de/tools/ascii-tree-from-indented-list): Wandelt eine eingerückte hierarchische Liste (2/4 Leerzeichen oder Tab; optionale Präfixe -, *, 1.) in einen kopierbaren ASCII-Verzeichnisbaum um. Zwei Stile: Unicode-Rahmen und klassisches ASCII. Schalter für vollständige Führungslinien, nachfolgende Leerzeichen und Blätter in Klammern.

## Beispiele

- [Markdown-Beispiele](https://elysiatools.com/de/samples/markdown-samples): Markdown-Formatbeispiele von einfachen bis komplexen Dokumentstrukturen
- [Markdown-Viewer Beispiele](https://elysiatools.com/de/samples/markdown-viewer-samples): Markdown-Beispiele fur README-Vorschau, Dokumentations-Rendering und Markup-Tests
- [Markdown Foliensatz Beispiele](https://elysiatools.com/de/samples/md-slide-deck-to-pdf): Remark/Marp Markdown Decks zum Testen des PDF Exports
- [PDF-Beispiele](https://elysiatools.com/de/samples/pdf-samples): Generierte PDF-Beispiele von Tools zwischen 2026-02-01 und 2026-02-10