Convertisseur de callouts Markdown
Convertir les blocs de callouts et admonitions entre syntaxe GitHub, Obsidian, Docusaurus et MkDocs.
Convertisseur de callouts Markdown
Les blocs de callouts—les boîtes "Note", "Conseil" ou "Avertissement" dans les README et les sites de documentation—sont écrits différemment sur chaque plateforme. GitHub utilise les alertes de bloc de citation comme `> [!NOTE]`, Obsidian étend cette syntaxe avec des titres personnalisés et des flèches repliables, Docusaurus enveloppe le contenu dans des clôtures `:::tip`, et MkDocs (et Material for MkDocs) utilise des blocs `!!! note` indentés avec `???` pour les pliables. Déplacer la documentation entre les outils signifie généralement réécrire chaque callout à la main—cet outil les convertit automatiquement.
Choisissez une notation source et cible dans le panneau d'options, puis collez le contenu écrit dans le format source. Chaque callout reconnu est analysé et réécrit dans la syntaxe cible; tout le reste de l'entrée—paragraphes, en-têtes, autre Markdown—passe inchangé. "Conserver le titre personnalisé du bloc" préserve un en-tête comme celui d'Obsidian `> [!info] Heads up` quand la cible le supporte (GitHub n'a pas de syntaxe de titre, donc un titre conservé devient une ligne en gras à la place). "Conserver l'état pliable/dépliable" préserve les marqueurs de pli `+`/`-` d'Obsidian et la syntaxe `???`/`???+` de MkDocs où la cible a un équivalent; GitHub et Docusaurus n'ont pas de callouts pliables, donc le basculement n'a aucun effet là-bas. "Normaliser le type de bloc" mappe les noms moins courants (important, attention, succès, question…) sur les cinq types que tous les formats partagent: note, conseil, avertissement, danger et info.
Le corps de chaque callout est préservé exactement tel qu'écrit, y compris les listes imbriquées, la mise en forme en ligne, les liens et les blocs de code clôturés—ce sont simplement des lignes ordinaires dans le bloc. Plusieurs callouts dans un document se convertissent en une seule passe, et les fins de ligne Windows et Unix sont traitées de la même manière.
Tout s'exécute localement dans votre navigateur; votre documentation n'est jamais téléchargée nulle part. Copiez le résultat, téléchargez-le en tant que fichier .txt, ou renvoyez la sortie à l'entrée pour enchaîner une autre conversion.