Ugrás a tartalomhoz
100% helyi

AsciiDoc–Markdown konverter

AsciiDoc szintaxist konvertálhat Markdown-ba, és vissza is, közvetlenül a böngészőjében.

Bemenet
Kimenet

AsciiDoc–Markdown konverter

Illessz be egy AsciiDoc dokumentumot — egy README-t, dokumentációs oldalt vagy wikből exportált szövegrészt — és az eszköz Markdown-ba írja át. A fejlécek (=, ==, egészen ======-ig) # és ###### között válnak. A félkövér (*word*) **word**-dá válik, míg a dőlt (_word_) és soron belüli kód (`word`) már mindkét formátumban azonos szintaxist követnek és változatlan marad. A link:url[text] és a https://url[text] formátum [text](url) lesz, az image::url[alt] ![alt](url) lesz, a ---- közé zárt [source,language] blokk kódblokk lesz, és a |=== táblázat Markdown csőtáblázattá alakul fejléc-elválasztó sorral. A NOTE, TIP, WARNING, IMPORTANT és CAUTION megjegyzések blokk-idézetekké vagy GitHub-stílusú riasztásokká válnak, és az egész fordított irányban is működik, Markdown-ból vissza AsciiDoc-ba az irány lehetőség segítségével.

A többi lehetőség az részleteket alakítja: a fejléc stílusa az ATX (#) vagy Setext (= vagy - aláhúzás, csak az első és második szint — mélyebb fejlécek ATX-re állnak vissza) közül választ; a megjegyzés formátuma egyszerű idézeteket vagy GitHub-riasztásokat választhat; a felsorolás stílusa az emprirált listáknál kötőjelet vagy csillagot választ; és az attribútumok elöljegyzésként való megtartása az AsciiDoc :name: value sorait YAML blokkká alakítja ahelyett, hogy eldobná, tükrözve a fordított irányban is.

Ez egy könnyű, mintázat-alapú konverter, nem teljes elemzőprogram, így a fenti szerkezeteknél működik a legjobban. A számozott listák mindig "1." vagy "." formátumot adnak — a megjelenítők szekvenciálisan számoznak függetlenül a marker saját számjegyeitől, ezért a számozás nem módosul. A Windows és Unix-sorvégek ugyanúgy kezelhetők, és az összesítés bejövő sorokat, kimenő sorokat és konvertált elemeket jelent.

Mindenki helyileg fut a böngészőben gépelés közben — semmi, amit beillesztesz, nem kerül fel, nincs naplózva vagy bárhova elküldve. Másolja ki az eredményt, töltse le .txt fájlként, vagy küldje vissza az inputba egy újabb feldolgozáshoz.

Gyakori kérdések

Kezel mindkét irányban — AsciiDoc-ból Markdown-ba és Markdown-ból AsciiDoc-ba?
Igen. Az irány lehetőség váltja az olvasott és az előállított formátumot, és a csere a jelenlegi kimenetet is visszahelyre másolja, így ellenőrizheti az oda-vissza konverziót.
Miért jönnek ki a számozott listák mindig "1." vagy "." formátumban?
Mind a Markdown, mind az AsciiDoc megjelenítők szekvenciálisan számoznak függetlenül attól, hogy a marker milyen számjegyet vagy sok pont tartalmazhat, így az azonos marker-felírás helyes számozású kimenetet produkál anélkül, hogy a konverternek nyomon kell követnie a számlálókat.
Mi történik az AsciiDoc szerkezetekkel, amelyeket az eszköz nem ismer?
A támogatott halmazon kívüli bármi — fejlécek, félkövér, hivatkozások, képek, listaelemek, egy sorban táblázatok, megjegyzések, listák és :name: value attribútumok — egyszerű szövegként maradnak ahelyett, hogy sejtésbe mennénk, így a kimenet kiszámítható marad az ismeretlen markup csendes megrongálása helyett.
Képes-e iç szintű vagy többsoros táblázatokat konvertálni?
Az általános kompakt formátumot támogatja, ahol az egyes táblázat sorok a |=== elhatárolók között (AsciiDoc) vagy szabványos csőtáblázatként a fejléc-elválasztó sorral (Markdown) állnak. Az AsciiDoc táblázatok, amelyeket egy cellával soronként és üres sorelválasztóval írnak, nem kerülnek rekonstruálásra.
Fel van töltve a dokumentumom valahova?
Nem. A konvertálás teljes egészében a böngészőjében fut — semmi, amit beillesztesz, soha nem hagyja el az eszközöd.