Konvertor Markdown calloutů
Převádějte callout a admonition bloky mezi GitHub, Obsidian, Docusaurus a MkDocs syntaxí.
Konvertor Markdown calloutů
Callout bloky—rámeček s poznámkami "Note", "Tip" nebo "Warning" v README a na dokumentačních stránkách—se píší jinak v každé platformě. GitHub používá blockquote alerts jako `> [!NOTE]`, Obsidian rozšiřuje tuto syntaxi o vlastní nadpisy a rozbalovací šipky, Docusaurus obaluje obsah v `:::tip` ohradách a MkDocs (a Material for MkDocs) používá odsazené `!!! note` bloky s `???` pro skládací. Přesun dokumentace mezi nástroji obvykle znamená ruční přepsání všech calloutů—tento nástroj je konvertuje automaticky.
Z panelu možností vyberte zdrojový a cílový formát a poté vložte obsah napsaný ve zdrojovém formátu. Každý rozpoznaný callout se analyzuje a přepíše v cílové syntaxi; všechno ostatní ve vstupu—odstavce, nadpisy, další Markdown—projde beze změny. "Zachovat vlastní nadpis bloku" zachovává nadpis jako Obsidianův `> [!info] Heads up` když to cíl podporuje (GitHub nemá syntaxi nadpisu, takže zachovaný nadpis se místo vynechání stane tučným prvním řádkem). "Zachovat skládací stav" zachovává Obsidiánovy značky `+`/`-` na skládání a MkDocsovy `???`/`???+` kde má cíl ekvivalent; GitHub a Docusaurus nemají skládací callouty, takže přepínač tam nemá efekt. "Normalizovat typ bloku" mapuje méně běžné názvy (important, caution, success, question…) na pět typů, které sdílí všechny formáty: note, tip, warning, danger a info.
Tělo každého calloutu se zachovává přesně tak, jak je napsáno, včetně vnořených seznamů, formátování textu, odkazů a oplocených bloků kódu—to jsou jen běžné řádky v bloku. Více calloutů v jednom dokumentu se konvertuje v jednom průchodu a Windows i Unix ukončovače řádků se zpracovávají stejným způsobem.
Všechno běží lokálně ve vašem prohlížeči; vaše dokumentace se nikdy nenahrajete nikam. Zkopírujte výsledek, stáhněte si jej jako .txt soubor nebo pošlete výstup zpět na vstup a řetězujte další konverzi.