Preskoči na sadržaj
100% lokalno

Konverter Markdown opomena

Pretvori blokove opomena i admonišenja između GitHub, Obsidian, Docusaurus i MkDocs sintakse.

Unos
Rezultat

Konverter Markdown opomena

Blokovi opomena—okvučeni "Napomena", "Savjet" ili "Upozorenje" odsječci u README datotekama i dokumentaciji—pišu se drugačije na svakoj platformi. GitHub koristi blockquote alerts kao `> [!NOTE]`, Obsidian proširuje tu sintaksu s prilagođenim naslovima i sklapljivim strelicama, Docusaurus obavija sadržaj u `:::tip` ograđenim dijelovima, a MkDocs (i Material for MkDocs) koristi uvučene `!!! note` blokove s `???` za sklapljive. Premještanje dokumentacije između alata obično znači ručno prepisivanje svakog bloka opomena—ovaj alat je pretvara automatski.

Odaberi izvorni i ciljni format iz opcija, zatim zalijepi sadržaj napisan u izvornom formatu. Svaki prepoznati blok opomena se rastavlja i prepisuje u ciljnoj sintaksi; sve ostalo u ulazu—odlomci, naslovi, drugi Markdown—prolazi nepromijenjen. "Zadrži naslove blokova" čuva naslov kao Obsidian's `> [!info] Heads up` kad ciljni format to podržava (GitHub nema sintakse za naslov, pa se zadržani naslov pretvara u debel prvi redak umjesto). "Zadrži stanje sklapanja" čuva Obsidian's `+`/`-` markere i MkDocs's `???`/`???+` sintaksu gdje cilj ima ekvivalent; GitHub i Docusaurus nemaju sklapljive blokove, pa ova opcija nema učinka. "Standardiziraj tip" mapira manje česte nazive (important, caution, success, question…) na pet tipova koje podržavaju svi formati: note, tip, warning, danger i info.

Telo svakog bloka je sačuvano točno kako je napisano, uključujući ugniježđene liste, inline formatiranje, linkove i ograđene kod blokove—to su samo obični redaci unutar bloka. Više blokova u jednom dokumentu se pretvara u jednom prolazu, a Windows i Unix završetci linija se obrađuju na isti način.

Sve se izvršava lokalno u pregledniku; tvoja dokumentacija se nikada ne učitava nikamo. Kopiraj rezultat, preuzmi kao .txt datoteku, ili pošalji izlaz natrag u ulaz za dodatne konverzije.

FAQ

Koje vrste opomena prepoznaje?
Bilo koje ime tipa u izvornoj sintaksi—note, tip, warning, danger, info i platformski specifične kao important ili faq. Uključi "Standardiziraj tip" da mapiraš manje česte nazive na pet tipova koje podržavaju svi formati.
Što se dogodi s prilagođenim naslovom kad ciljni format ga ne podržava?
GitHub alerts nemaju sintaksu za naslov, pa se zadrža naslov dodaje kao debel prvi redak unutar bloka umjesto da se izbaci.
Podržavaju li se sklapljivi blokovi?
Da, između Obsidiana ("+"/"-" nakon tipa) i MkDocsa ("???"/"???+"). GitHub i Docusaurus nemaju sklapljivu sintaksu, pa se stanje izbacuje pri konverziji u bilo koji od njih.
Mogu li liste i kod blokovi unutar opomene preživjeti konverziju?
Da. Sve što je unutar tijela opomene se prebacuje kako je—ugniježđene liste, inline formatiranje i ograđeni kod blokovi uključeni.
Je li moj dokument učitan ikamo?
Ne. Konverzija se izvršava cijelo u pregledniku—tvoj tekst nikada ne napušta tvoj uređaj.