Nemokamas konverteris

Pažymėjimas į HTML keitiklis

Paverskite Markdown tekstą į gamybai paruoštą HTML kodą su tiesioginės peržiūros palaikymu.

Apie šį įrankį

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.

Kodėl verta konvertuoti Markdown į HTML

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.

Kaip naudoti

Įklijuokite Markdown, gaukite HTML.

  1. Pridėkite savo žymėjimą: Įklijuokite žymėjimo tekstą į įvesties sritį arba palikite .md failą. Veikia ir standartinė Markdown, ir GitHub Flavoured Markdown sintaksė.
  2. Konvertuoti: Pažymėtas išanalizuoja žymėjimą į AST ir išsiunčia HTML. Standartiniai įterptieji elementai (pabrėžimas, stiprūs, nuorodos, kodas, vaizdai), blokų elementai (antraštės, pastraipos, sąrašai, kabutės) ir GFM plėtiniai (lentelės, aptvertas kodas, užduočių sąrašai, automatinės nuorodos) pateikiami teisingai.
  3. Peržiūra: Peržiūrėkite pateiktą HTML peržiūros skydelyje. Patvirtinkite, kad kodų blokai, lentelės ir kiti sudėtingi elementai atrodo taip, kaip tikėtasi.
  4. Nukopijuokite arba atsisiųskite: Nukopijuokite HTML į mainų sritį, kad galėtumėte įklijuoti į TVS, arba išsaugokite kaip .html, kad galėtumėte naudoti atskirai. Išvestis yra semantinis HTML5 be eilutinių stilių.

Įprasto naudojimo atvejai

Techninės detalės

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ę.

Geriausia praktika

Dažnai užduodami klausimai

Ar MARKDOWN konvertavimas į HTML keičia turinį?
Turinys išsaugomas kuo tiksliau. Tačiau kai kurios su formatu susijusios funkcijos gali neturėti tiesioginių atitikmenų, todėl gali atsirasti nedidelių formatavimo skirtumų.
Kam naudojamas HTML formatas?
HTML (HyperText Markup Language) pirmiausia naudojamas tinklalapiams ir žiniatinklio turiniui.
Ar yra kokių nors apribojimų, kuriuos reikia žinoti?
Palaikomi failai iki 50 MB. Labai didelių ar sudėtingų failų apdorojimas gali užtrukti ilgiau. Visa konversija vyksta jūsų naršyklėje, todėl apdorojimo greitis priklauso nuo jūsų įrenginio.
Ar ši konversija saugi ir privati?
Taip. Visas apdorojimas vyksta lokaliai jūsų naršyklėje. Jūsų duomenys niekada nepalieka jūsų įrenginio – neįkeliama į serverį, neapdorojama debesyje, nerenkama duomenų.
Ar palaikomos emocijos?
Unikodo jaustukai praeina tiesiogiai (įvedus širdies jaustuką išvestyje rodoma širdelė). GitHub stiliaus: jaustukai: trumpieji kodai nėra konvertuojami pagal numatytuosius nustatymus; pridėkite plėtinį, jei to reikia.
Ar mano Markdown įkeltas į serverį?
Ne. Pažymėti veikia jūsų naršyklėje; konversija įvyksta tik jūsų įrenginyje.
Ar galiu pridėti tinkintą stilių prie HTML?
Taip, po konvertavimo. Išvestis yra paprastas semantinis HTML; pritaikykite savo CSS stiliaus antraštėms, kodų blokams, lentelėms ir kitiems elementams.
Ar tai palaiko išnašas?
Standartinis CommonMark nenurodo išnašos sintaksės. Kai kurie Markdown plėtiniai palaiko [^1] išnašos sintaksę; šis keitiklis vadovaujasi GFM, kuris neapima išnašų.