Convertitore di callout Markdown
Converti blocchi di callout e admonizioni tra sintassi GitHub, Obsidian, Docusaurus e MkDocs.
Convertitore di callout Markdown
I blocchi di callout—i riquadri "Nota", "Consiglio" o "Avvertenza" nei README e nei siti di documentazione—sono scritti diversamente su ogni piattaforma. GitHub utilizza gli avvisi di blocco di citazione come `> [!NOTE]`, Obsidian estende questa sintassi con titoli personalizzati e frecce richiudibili, Docusaurus avvolge il contenuto in recinzioni `:::tip`, e MkDocs (e Material for MkDocs) utilizza blocchi `!!! note` indentati con `???` per i richiudibili. Spostare la documentazione tra gli strumenti di solito significa riscrivere manualmente ogni callout—questo strumento li converte automaticamente.
Scegli una notazione di origine e di destinazione dal pannello delle opzioni, quindi incolla il contenuto scritto nel formato di origine. Ogni callout riconosciuto viene analizzato e riscritto nella sintassi di destinazione; tutto il resto nell'input—paragrafi, intestazioni, altro Markdown—passa invariato. "Mantieni il titolo personalizzato del blocco" preserva un'intestazione come quella di Obsidian `> [!info] Heads up` quando la destinazione la supporta (GitHub non ha sintassi del titolo, quindi un titolo conservato diventa una riga in grassetto al suo posto). "Mantieni lo stato pieghevole/collassabile" preserva i marcatori di piega `+`/`-` di Obsidian e la sintassi `???`/`???+` di MkDocs dove la destinazione ha un equivalente; GitHub e Docusaurus non hanno callout richiudibili, quindi l'interruttore non ha alcun effetto lì. "Normalizza il tipo di blocco" mappa i nomi meno comuni (importante, attenzione, successo, domanda…) sui cinque tipi che tutti i formati condividono: nota, consiglio, avvertenza, pericolo e info.
Il corpo di ogni callout viene preservato esattamente come scritto, inclusi gli elenchi annidati, la formattazione inline, i link e i blocchi di codice recintati—questi sono semplicemente righe ordinarie all'interno del blocco. Più callout in un documento si convertono in un unico passaggio, e i terminatori di riga Windows e Unix vengono gestiti allo stesso modo.
Tutto viene eseguito localmente nel tuo browser; la tua documentazione non viene mai caricata da nessuna parte. Copia il risultato, scaricalo come file .txt o reinvia l'output all'input per concatenare un'altra conversione.