Brezplačni pretvornik

Znižaj na Pretvornik HTML

Pretvorite besedilo Markdown v kodo HTML, pripravljeno za proizvodnjo, s podporo za predogled v živo.

O tem orodju

Markdown je lahek označevalni jezik, ki ga je leta 2004 ustvaril John Gruber, da bi piscem omogočil ustvarjanje strukturiranega HTML z uporabo konvencij za navadno besedilo: zgoščeni znaki za naslove, zvezdice za poudarke, vezaji za sezname, zamaknjeni bloki za kodo. Oblika zapisa je postala privzeta za datoteke README, tehnično dokumentacijo, osnutke spletnih dnevnikov, generatorje statičnih spletnih mest in kateri koli kontekst, kjer bi moralo biti pisanje berljivo kot navadno besedilo in kot upodobljeni izhod. Pretvorba Markdown v HTML je korak upodabljanja, ki spremeni izvor v spletno stran.

Ta pretvornik uporablja označeno knjižnico, najbolj razširjen upodabljalnik Markdown v JavaScriptu. Označeno podpira CommonMark in GitHub Flavored Markdown (GFM), kar pomeni, da tabele, ograjeni bloki kode, seznami opravil, prečrtanje in samodejno povezovanje delujejo pravilno poleg standardnih funkcij Markdown.

Izhod je navaden HTML – semantične oznake za naslove, odstavke, sezname, povezave in slike ter kljuke razredov za bloke kode, kjer jih pričakujejo orodja za označevanje sintakse. Izhod čisto prilepite v kateri koli CMS, vdelate v statične generatorje spletnih mest ali služite kot samostojni .html. Dodan ni CSS ali JavaScript; oblikovanje rezultata je prepuščeno vašemu nadaljnjemu kontekstu.

Zakaj pretvoriti Markdown v HTML

Markdown je format, ki ga imajo najraje pisci in razvijalci; HTML je format, ki ga upodabljajo brskalniki. Večina generatorjev statičnih spletnih mest in platform CMS pretvori Markdown v HTML v zakulisju, vendar včasih potrebujete pretvorbo kot samostojen korak – prilepite v CMS, ki nima podpore za Markdown, ustvarite HTML za e-pošto, naredite hiter predogled ali ekstrahirate upodobljeni rezultat za nadaljnjo obdelavo.

HTML je tudi kanonična oblika za katero koli vsebino, ki bo na koncu prikazana v brskalniku. E-poštna glasila, sestavljena iz osnutkov Markdown, strani z dokumentacijo, vdelanih v večje aplikacije HTML, in objave v spletnih dnevnikih, prilepljene v urejevalnike, ki pričakujejo HTML, imajo koristi od čiste pretvorbe.

Kako uporabljati

Prilepite Markdown, pridobite HTML.

  1. Dodajte svoj Markdown: Prilepite besedilo Markdown v območje za vnos ali spustite datoteko .md. Delujeta tako standardna sintaksa Markdown kot GitHub Flavored Markdown.
  2. Pretvori: Marked razčleni Markdown v AST in odda HTML. Standardni elementi v vrstici (poudarek, močno, povezave, koda, slike), blokovni elementi (naslovi, odstavki, seznami, blokovni narekovaji) in razširitve GFM (tabele, ograjena koda, seznami opravil, samodejne povezave) so pravilno upodobljeni.
  3. Predogled: Preglejte upodobljeni HTML na plošči za predogled. Potrdite, da so kodni bloki, tabele in drugi kompleksni elementi prikazani po pričakovanjih.
  4. Kopirajte ali prenesite: Kopirajte HTML v odložišče za lepljenje v CMS ali shranite kot .html za samostojno uporabo. Rezultat je semantični HTML5 brez vgrajenih slogov.

Pogosti primeri uporabe

Tehnične podrobnosti

Marked uporablja arhitekturo dveh prehodov. Leksor tokenizira vnos v žetone na ravni bloka (naslovi, odstavki, seznami, bloki kode) in žetone v vrstici (poudarki, povezave, slike). Razčlenjevalnik se sprehaja po toku žetonov in oddaja HTML, pri čemer uporabi kljuke upodabljalnika za vsako vrsto žetona.

Razširitve GitHub Flavored Markdown so privzeto omogočene: tabele (z uporabo cevne sintakse), ograjeni bloki kode (trojne povratne kljukice z jezikovnimi namigi), seznami opravil (- [ ] in - [x]), prečrtano (z uporabo dvojnih tild) in samodejno povezovanje URL-jev. Bloki kode oddajajo vnaprej ovito kodo z izbirnim jezikovnim razredom za označevanje sintakse v smeri toka.

Sanacija izhoda je prepuščena nadaljnjim porabnikom. Označeno oddaja vse, kar proizvede vnos, vključno z neobdelanim HTML-jem, vdelanim v Markdown. Če sprejmete vnos, ki ni vreden zaupanja, pred upodabljanjem v brskalniku zaženite izhod prek DOMPurify ali podobnega čistilca HTML.

Najboljše prakse

Pogosta vprašanja

Ali pretvorba MARKDOWN v HTML spremeni vsebino?
Vsebina je ohranjena čim bolj natančno. Vendar pa nekatere funkcije, specifične za obliko, morda nimajo neposrednih ustreznikov, zato lahko pride do manjših razlik v oblikovanju.
Za kaj se uporablja format HTML?
HTML (HyperText Markup Language) se uporablja predvsem za spletne strani in spletno vsebino.
Ali obstajajo kakšne omejitve, na katere se morate zavedati?
Podprte so datoteke do 50 MB. Obdelava zelo velikih ali zapletenih datotek lahko traja dlje. Vse pretvorbe se zgodijo v vašem brskalniku, zato je hitrost obdelave odvisna od vaše naprave.
Je ta pretvorba varna in zasebna?
ja Vsa obdelava poteka lokalno v vašem brskalniku. Vaši podatki nikoli ne zapustijo vaše naprave – brez nalaganja na strežnik, brez obdelave v oblaku, brez zbiranja podatkov.
Ali so emojiji podprti?
Emodžiji Unicode gredo neposredno skozi (vtipkanje emodžija srca prikaže srce v izpisu). GitHub slog :emoji: kratke kode niso privzeto pretvorjene; dodajte razširitev, če jo potrebujete.
Ali je moj Markdown naložen na strežnik?
Ne. Označeno se izvaja v vašem brskalniku; pretvorba se v celoti zgodi v vaši napravi.
Ali lahko HTML-ju dodam slog po meri?
Da, po preobrazbi. Rezultat je navaden semantični HTML; uporabite svoj lastni CSS za slogovne naslove, kodne bloke, tabele in druge elemente.
Ali podpira sprotne opombe?
Standardni CommonMark ne določa sintakse sprotne opombe. Nekatere razširitve Markdown podpirajo sintakso sprotne opombe [^1]; ta pretvornik sledi GFM, ki ne vključuje sprotnih opomb.