Konwerter calloutów Markdown
Konwertuj bloki callout i admonition między składnią GitHub, Obsidian, Docusaurus i MkDocs.
Konwerter calloutów Markdown
Bloki callout—ramki z uwagami "Note", "Tip" lub "Warning" w README i na stronach dokumentacji—pisane są inaczej na każdej platformie. GitHub używa blockquote alerts jak `> [!NOTE]`, Obsidian rozszerza tę składnię o niestandardowe tytuły i rozwijane strzałki, Docusaurus opakowuje zawartość w ogranicznikach `:::tip` a MkDocs (i Material for MkDocs) używa wcięciowych bloków `!!! note` z `???` dla zwijanych. Przenoszenie dokumentacji między narzędziami zwykle oznacza ręczne przepisanie wszystkich calloutów—to narzędzie konwertuje je automatycznie.
Z panelu opcji wybierz format źródłowy i docelowy, a następnie wklej zawartość napisaną w formacie źródłowym. Każdy rozpoznany callout jest analizowany i przepisywany w składni docelowej; wszystko inne na wejściu—akapity, nagłówki, inny Markdown—przechodzi bez zmian. "Zachowaj niestandardowy tytuł bloku" zachowuje nagłówek taki jak Obsidianov `> [!info] Heads up` gdy cel to obsługuje (GitHub nie ma składni tytułu, więc zachowany tytuł zamiast być pominięty staje się pogrubioną pierwszą linią). "Zachowaj stan zwijanego" zachowuje znaczniki Obsidiana `+`/`-` na zwijanie i MkDocs `???`/`???+` gdzie cel ma ekwiwalent; GitHub i Docusaurus nie mają zwijanych calloutów, więc przełącznik tam nie ma efektu. "Normalizuj typ bloku" mapuje mniej powszechne nazwy (important, caution, success, question…) na pięć typów, które dzielą wszystkie formaty: note, tip, warning, danger i info.
Zawartość każdego calloutu jest zachowywana dokładnie tak, jak jest napisana, łącznie z zagnieżdżonymi listami, formatowaniem tekstu, linkami i ogrodzymi blokami kodu—to tylko zwykłe linie w bloku. Wiele calloutów w jednym dokumencie konwertuje się w jednym przejściu a zakończenia linii Windows i Unix są obsługiwane w ten sam sposób.
Wszystko działa lokalnie w przeglądarce; dokumentacja nigdy się nie przesyła. Skopiuj wynik, pobierz go jako plik .txt lub wyślij wynik z powrotem na wejście i łańcuchuj kolejną konwersję.