Markdown-callout-converter
Converteer callout- en admonition-blokken tussen GitHub, Obsidian, Docusaurus en MkDocs-syntax.
Markdown-callout-converter
Callout-blokken—de ingeramde 'Notitie'-, 'Tip'- of 'Waarschuwing'-zijbalken in README's en documentatiesites—worden door elk platform anders geschreven. GitHub gebruikt blockquote-waarschuwingen zoals `> [!NOTE]`, Obsidian breidt deze syntaxis uit met aangepaste titels en inklappijlen, Docusaurus verpakt inhoud in `:::tip`-hekken, en MkDocs (en Material for MkDocs) gebruikt ingesprongen `!!! note`-blokken met `???` voor inklapbare. Het verplaatsen van documentatie tussen tools betekent meestal dat elke callout handmatig moet worden herschreven—deze tool converteert ze automatisch.
Selecteer een bron- en doelnotatie in het optiespaneel en plak vervolgens inhoud die in de bronindeling is geschreven. Elke herkende callout wordt geparseerd en in de doelsyntaxis herschreven; alles anders in de invoer—alinea's, koppen, ander Markdown—wordt onveranderd doorgegeven. 'Aangepaste bloktitel behouden' behoudt een kop zoals Obsidians `> [!info] Heads up` wanneer het doel dit ondersteunt (GitHub heeft geen titel-syntaxis, dus een bewaarde titel wordt in plaats daarvan een vetgedrukte eerste regel). 'Opvouw-/inklaptoestand behouden' behoudt Obsidians `+`/`-`-vouwtekens en MkDocs's `???`/`???+`-syntaxis waar het doel een equivalent heeft; GitHub en Docusaurus hebben geen inklapbare callouts, dus de schakelaar heeft daar geen effect. 'Bloktype normaliseren' wijst minder voorkomende namen (important, caution, success, question…) toe aan de vijf typen die elk format deelt: note, tip, warning, danger en info.
De inhoud van elke callout blijft precies zoals geschreven, inclusief geneste lijsten, inline-opmaak, koppelingen en omheinde codeblokken—dit zijn gewoon normale regels in het blok. Meerdere callouts in één document worden in één keer geconverteerd, en Windows- en Unix-regeleinden worden op dezelfde manier verwerkt.
Alles wordt lokaal in uw browser uitgevoerd; uw documentatie wordt nergens geüpload. Kopieer het resultaat, download het als .txt-bestand, of stuur de uitvoer terug naar de invoer om nog een conversie uit te voeren.