Pažymėjimas į HTML keitiklis
Paverskite Markdown tekstą į gamybai paruoštą HTML kodą su tiesioginės peržiūros palaikymu.
Paverskite Markdown tekstą į gamybai paruoštą HTML kodą su tiesioginės peržiūros palaikymu.
Markdown yra lengva žymėjimo kalba, kurią 2004 m. sukūrė Johnas Gruberis, kad rašytojai galėtų kurti struktūrinį HTML naudodami paprasto teksto taisykles: maišos simbolius antraštėms, žvaigždutes paryškinimui, brūkšnelius sąrašams, įtrauktus blokus kodui. Formatas tapo numatytuoju README failų, techninės dokumentacijos, tinklaraščio juodraščių, statinių svetainių generatorių ir bet kokio konteksto, kuriame tekstas turėtų būti skaitomas kaip paprastas tekstas ir pateikta išvestis, formatu. Markdown konvertavimas į HTML yra atvaizdavimo veiksmas, paverčiantis šaltinį tinklalapiu.
Šis konverteris naudoja pažymėtą biblioteką – plačiausiai naudojamą „JavaScript“ Markdown atvaizdavimo priemonę. Marked palaiko „CommonMark“ ir „GitHub Flavoured Markdown“ (GFM), o tai reiškia, kad lentelės, atskirti kodų blokai, užduočių sąrašai, perbraukimas ir automatinis susiejimas veikia tinkamai, be standartinių Markdown funkcijų.
Išvestis yra paprastas HTML – semantinės žymos, skirtos antraštėms, pastraipoms, sąrašams, nuorodoms ir vaizdams, taip pat klasių kabliukai kodo blokams ten, kur sintaksės paryškinimo įrankiai jų tikisi. Išvesties įklijuokite į bet kurią TVS, įterpkite į statinius svetainių generatorius arba tarnauja kaip atskiras .html. CSS ar JavaScript nepridėta; rezultato stilius paliekamas jūsų tolesniam kontekstui.
Markdown yra formatas, kuriam pirmenybę teikia rašytojai ir kūrėjai; HTML yra formatas, kurį pateikia naršyklės. Dauguma statinių svetainių generatorių ir TVS platformų konvertuoja Markdown į HTML užkulisiuose, tačiau kartais reikia konvertuoti kaip atskirą veiksmą – įklijuoti į TVS, kuri neturi Markdown palaikymo, generuoti HTML el. laiškams, sukurti greitą peržiūrą arba išgauti pateiktą išvestį tolesniam apdorojimui.
HTML taip pat yra kanoninis bet kokio turinio, kuris galiausiai bus rodomas naršyklėje, formatas. El. pašto naujienlaiškiai, sukurti iš Markdown juodraščių, dokumentacijos puslapiai, įterpti į didesnes HTML programas, ir tinklaraščio įrašai, įklijuoti į redaktorius, kurie tikisi, kad HTML bus naudingas švarus konvertavimas.
Įklijuokite Markdown, gaukite HTML.
Pažymėtas naudoja dviejų praėjimų architektūrą. Lekseris suskirsto įvestį į bloko lygio žetonus (antraštes, pastraipas, sąrašus, kodų blokus) ir eilutinius žetonus (kirčiuoti, nuorodos, vaizdai). Analizatorius eina žetonų srautu ir išleidžia HTML, taikydamas atvaizdavimo kabliukus kiekvienam žetono tipui.
„GitHub Flavoured Markdown“ plėtiniai įgalinti pagal numatytuosius nustatymus: lentelės (naudojant vamzdžių sintaksę), atskirti kodų blokai (trigubos atgalinės žymos su kalbos užuominomis), užduočių sąrašai (- [ ] ir - [x]), perbraukimas (naudojant dvigubas tildes) ir automatinis URL susiejimas. Kodo blokai skleidžia iš anksto apvyniotą kodą su pasirenkama kalbos klase, kad būtų paryškinta sintaksė.
Išvesties dezinfekavimas paliekamas tolesniems vartotojams. Pažymėtas skleidžia viską, ką sukuria įvestis, įskaitant neapdorotą HTML, įterptą į Markdown. Jei priimate nepatikimą įvestį, prieš pateikdami naršyklėje paleiskite išvestį per DOMPurify arba panašų HTML valymo priemonę.