Markdown-Callout-Konverter
Konvertiert Callout- und Admonition-Blöcke zwischen GitHub, Obsidian, Docusaurus und MkDocs-Syntax.
Markdown-Callout-Konverter
Callout-Blöcke—die eingerahmten „Notiz"-, "Tipp"- oder "Warnung"-Abschnitte in READMEs und Dokumentations-Websites—werden von jeder Plattform unterschiedlich geschrieben. GitHub verwendet Blockzitate-Warnungen wie `> [!NOTE]`, Obsidian erweitert diese Syntax um benutzerdefinierte Titel und Falt-Pfeile, Docusaurus wickelt Inhalte in `:::tip`-Zäune ein, und MkDocs (sowie Material for MkDocs) nutzt eingerückte `!!! note`-Blöcke mit `???` für einklappbare. Die Verschiebung von Dokumentation zwischen Tools bedeutet normalerweise, dass jeder Callout von Hand umgeschrieben werden muss—dieses Tool konvertiert sie automatisch.
Wählen Sie eine Quell- und Zielschreibweise aus dem Optionsbereich, dann fügen Sie Inhalte ein, die in der Quellformat geschrieben sind. Jeder erkannte Callout wird analysiert und in die Zielschreibweise umgeschrieben; alles andere in der Eingabe—Absätze, Überschriften, anderes Markdown—bleibt unverändert. "Benutzerdefinierte Block-Titel beibehalten" speichert eine Überschrift wie Obsidians `> [!info] Heads up`, wenn das Ziel diese unterstützt (GitHub hat keine Titel-Syntax, also wird ein beibehaltener Titel stattdessen zu einer fetten ersten Zeile). "Falt-/Einklappzustand beibehalten" speichert Obsidians `+`/`-`-Falt-Markierungen und MkDocs's `???`/`???+`-Syntax, wenn das Ziel ein Äquivalent hat; GitHub und Docusaurus haben keine einklappbaren Callouts, daher hat der Umschalter dort keine Auswirkung. "Block-Typ normalisieren" ordnet seltenere Namen (important, caution, success, question…) den fünf Typen zu, die jedes Format gemeinsam hat: note, tip, warning, danger und info.
Der Text jedes Callouts bleibt genau wie geschrieben, einschließlich verschachtelter Listen, Inline-Formatierung, Links und eingezäunter Code-Blöcke—das sind nur gewöhnliche Zeilen im Block. Mehrere Callouts in einem Dokument werden in einem Durchgang konvertiert, und Windows- sowie Unix-Zeilenumbrüche werden gleich behandelt.
Alles läuft lokal in Ihrem Browser ab; Ihre Dokumentation wird nirgendwo hochgeladen. Kopieren Sie das Ergebnis, laden Sie es als .txt-Datei herunter, oder senden Sie die Ausgabe zurück in die Eingabe, um eine weitere Konvertierung zu verketten.