Preskoči na vsebino
100% lokalno

Pretvornik Markdown opozoril

Pretvori opozorilne in admonitorske bloke med GitHub, Obsidian, Docusaurus in MkDocs sintakso.

Vhod
Izhod

Pretvornik Markdown opozoril

Opozorilni bloki—okvičeni "Opomba", "Nasvet" ali "Opozorilo" odlomki v README datotekah in dokumentaciji—so napisani drugače na vsaki platformi. GitHub uporablja blockquote alerts kot `> [!NOTE]`, Obsidian razširja to sintakso s prilagojenim naslovi in zlagljivimi puščicami, Docusaurus ovije vsebino v `:::tip` ogradami, MkDocs (in Material for MkDocs) pa koristi zamaknjene `!!! note` bloke s `???` za zlagljive. Selitev dokumentacije med orodji običajno pomeni ročno ponovno pisanje vsakega opozorilnega bloka—to orodje jih pretvori samodejno.

Izberi izvirni in ciljni format iz možnosti, nato prilepi vsebino napisano v izvirnem formatu. Vsak prepoznan opozorilni blok se razčleni in prepiše v ciljno sintakso; vse drugo v vnosu—odlomki, naslovi, drugi Markdown—ostane nespremenjen. "Ohrani naslove blokov" ohrani naslov kot Obsidian's `> [!info] Heads up` kadar ciljna oblika to podpira (GitHub nima sintakse za naslov, zato ohranjeni naslov postane podebeljen prvi red namesto); "Ohrani stanje zlaganja" ohrani Obsidian's `+`/`-` oznake in MkDocs's `???`/`???+` sintakso kjer ima cilj enakovredno; GitHub in Docusaurus nimata zlagljivih blokov, zato stanje padne pri pretvarjanju v enega od njiju. "Normaliziraj tip" preslika redkejša imena (important, caution, success, question…) na pet tipov, ki jih podpirajo vse oblike: note, tip, warning, danger in info.

Telo vsakega bloka se ohrani točno kot je napisano, vključno z ugnezdenimi seznami, vstavljenim oblikovanjem, povezavami in ograjenim kodo—to so samo navadni redki znotraj bloka. Več blokov v enem dokumentu se pretvori v enem prehodu, Windows in Unix zaključki vrstic pa se obdelajo na enak način.

Vse se izvršava lokalno v vašem brskalniku; vaša dokumentacija nikoli ni naložena nikamor. Kopiraj rezultat, prenesi kot .txt datoteko, ali pošlji izhod nazaj v vhod za dodatne pretvorbe.

FAQ

Katere vrste opozoril prepozna?
Katero koli ime tipa v izvirni sintaksi—note, tip, warning, danger, info in platformsko specifične kot important ali faq. Vključi "Normaliziraj tip" da preslikiš redkejša imena na pet tipov, ki jih podpirajo vse oblike.
Kaj se zgodi s prilagojenim naslovom, ko ga ciljna oblika ne podpira?
GitHub alerts nimajo sintakse za naslov, zato se ohranjeni naslov doda kot podebeljen prvi red v bloku namesto da se izpusti.
Ali so podprta zlagljiva opozorila?
Da, med Obsidianom ("+"/"-" za tipom) in MkDocsom ("???"/"???+"). GitHub in Docusaurus nimata zlagljive sintakse, zato se stanje spusti pri pretvarjanju v enega od njiju.
Ali bodo seznami in kodni bloki v opozorilu preživeli pretvorbo?
Da. Vsega v telesu opozorila se ohrani kot je—ugnezdenimi seznami, vstavljenim oblikovanjem in ograjenim kodnimi bloki vključeni.
Ali je moja dokumentacija naložena nekam?
Ne. Pretvorba poteka povsem v vašem brskalniku—vaša besedila nikoli ne zapustijo vaše naprave.