Preskočiť na obsah
100% lokálne

Konvertor Markdown calloutov

Konvertovať callout a admonition bloky medzi GitHub, Obsidian, Docusaurus a MkDocs syntaxou.

Vstup
Výstup

Konvertor Markdown calloutov

Callout bloky—zapĺňané boxy s poznámkami "Note", "Tip" alebo "Warning" v README a na dokumentačných stránkach—sa píšu rôzne v každej platforme. GitHub používa blockquote alerts ako `> [!NOTE]`, Obsidian rozširuje túto syntax o vlastné nadpisy a rozbaľovacie šípky, Docusaurus obaľuje obsah v `:::tip` ohradách a MkDocs (a Material for MkDocs) používa odsadené `!!! note` bloky s `???` pre zbaliteľné. Presun dokumentácie medzi nástrojmi zvyčajne znamená ručné prepísanie všetkých calloutov—tento nástroj ich konvertuje automaticky.

Z panelu možností vyberte zdrojovú a cieľovú notáciu a potom vložte obsah napísaný v zdrojovom formáte. Každý rozpoznaný callout sa parsuje a prepisuje v cieľovej syntax; všetko ostatné v vstupe—odseky, nadpisy, ďalší Markdown—prejde nezmenené. "Zachovať vlastný nadpis bloku" zachováva nadpis ako Obsidianovo `> [!info] Heads up` keď cieľ to podporuje (GitHub nemá syntax nadpisu, takže zachovaný nadpis sa namiesto vyradenia stane tučným prvým riadkom). "Zachovať zložiteľný/zbaliteľný stav" zachováva Obsidianove značky `+`/`-` na skladanie a MkDocksove `???`/`???+` kde má cieľ ekvivalent; GitHub a Docusaurus nemajú zbaliteľné callouty, takže prepínač tam nemá efekt. "Normalizovať typ bloku" mapuje menej časte názvy (important, caution, success, question…) na päť typov, ktoré zdieľajú všetky formáty: note, tip, warning, danger a info.

Telo každého calloutu sa zachováva presne tak, ako sa píše, vrátane vnorených zoznamov, formátovania text, odkazov a oplotených blokov kódu—to sú len bežné riadky v bloku. Viacero calloutov v jednom dokumente sa konvertuje v jednom prechode a Windows aj Unix ukončovače riadkov sa spracovávajú rovnakým spôsobom.

Všetko beží lokálne vo vašom prehliadači; vaša dokumentácia sa nikdy nenahráva nikam. Skopírujte výsledok, stiahnite si ho ako .txt súbor alebo pošlite výstup späť do vstupu a reťazite ďalšiu konverziu.

Časté otázky

Ktoré typy calloutov rozpoznáva?
Akýkoľvek názov typu v zdrojovej syntaxi—note, tip, warning, danger, info a špecifické pre platformu ako important alebo faq. Zapnite "Normalizovať typ bloku" na mapovanie menej častých názvov na päť typov, ktoré zdieľajú všetky formáty.
Čo sa stane s vlastným nadpisom, keď cieľový formát ho nepodporuje?
GitHub alerts nemajú syntax nadpisu, takže zachovaný nadpis sa v bloku namiesto vyradenia stane tučným prvým riadkom.
Sú podporované zbaliteľné callouty?
Áno, medzi Obsidianom ("+"/"-" za typom) a MkDockami ("???"/"???+"). GitHub a Docusaurus nemajú zbaliteľnú syntax, takže stav sa vyradí pri konverzii na ktoréhokoľvek.
Budú zoznamy a kódové bloky vnútri calloutu prežitý konverziou?
Áno. Všetko vnútri tela calloutu sa presne prenáša—vnorené zoznamy, formátovanie textu a oplotené kódové bloky zahrnuté.
Je môj dokument nahraný niekde?
Nie. Konverzia beží celá vo vašom prehliadači—váš text nikdy neopustí vaše zariadenie.