Bezmaksas pārveidotājs

Atzīme uz HTML pārveidotājs

Pārveidojiet Markdown tekstu ražošanai gatavā HTML kodā ar tiešā priekšskatījuma atbalstu.

Par šo rīku

Markdown ir viegla iezīmēšanas valoda, ko 2004. gadā izveidoja Džons Grūbers, lai ļautu rakstītājiem izveidot strukturētu HTML, izmantojot vienkārša teksta metodes: virsrakstiem ir jauktas rakstzīmes, uzsvariem — zvaigznītes, sarakstiem — defises, kodam — bloki ar atkāpēm. Formāts ir kļuvis par noklusējumu README failiem, tehniskajai dokumentācijai, emuāru melnrakstiem, statiskajiem vietņu ģeneratoriem un jebkuram kontekstam, kurā rakstītajam jābūt lasāmam kā vienkāršam tekstam un kā renderētai izvadei. Markdown konvertēšana uz HTML ir renderēšanas darbība, kas pārvērš avotu par tīmekļa lapu.

Šis pārveidotājs izmanto iezīmēto bibliotēku, visplašāk izmantoto Markdown renderētāju JavaScript. Marked atbalsta CommonMark un GitHub Flavored Markdown (GFM), kas nozīmē, ka tabulas, norobežoti kodu bloki, uzdevumu saraksti, pārsvītrojums un automātiskā saistīšana darbojas pareizi papildus standarta Markdown funkcijām.

Izvade ir vienkāršs HTML — semantiskie tagi virsrakstiem, rindkopām, sarakstiem, saitēm un attēliem, kā arī klases āķi kodu blokiem, kur tos paredz sintakses izcelšanas rīki. Izvades ielīmēšana ir tīra jebkurā SPS, tiek iegulta statiskos vietņu ģeneratoros vai kalpo kā atsevišķs .html. CSS vai JavaScript nav pievienots; rezultāta veidošana ir atstāta jūsu pakārtotā kontekstā.

Kāpēc pārvērst Markdown par HTML

Markdown ir formāts, kuram rakstītāji un izstrādātāji dod priekšroku; HTML ir pārlūkprogrammu renderētais formāts. Lielākā daļa statisko vietņu ģeneratoru un CMS platformu aizkulisēs pārvērš Markdown par HTML, taču dažreiz konvertēšana ir nepieciešama kā atsevišķa darbība — ielīmēšana SPS, kurai nav Markdown atbalsta, HTML ģenerēšana e-pastiem, ātra priekšskatījuma izveide vai renderētās izvades izvilkšana tālākai apstrādei.

HTML ir arī kanoniskais formāts jebkuram saturam, kas galu galā tiks parādīts pārlūkprogrammā. E-pasta informatīvie izdevumi, kas veidoti no Markdown melnrakstiem, dokumentācijas lapām, kas iegultas lielākās HTML lietojumprogrammās, un emuāra ziņojumiem, kas ielīmēti redaktoros, kuri sagaida, ka HTML gūs labumu no tīras konversijas.

Kā lietot

Ielīmējiet Markdown, iegūstiet HTML.

  1. Pievienojiet savu Markdown: Ielīmējiet Markdown tekstu ievades apgabalā vai nometiet .md failu. Darbojas gan standarta Markdown, gan GitHub Flavored Markdown sintakse.
  2. Konvertēt: Atzīmēts parsē atzīmes par AST un izstaro HTML. Standarta iekļautie elementi (uzsvars, spēcīgs, saites, kods, attēli), bloka elementi (virsraksti, rindkopas, saraksti, pēdiņas) un GFM paplašinājumi (tabulas, norobežots kods, uzdevumu saraksti, automātiskās saites) tiek renderēti pareizi.
  3. Priekšskatījums: Pārbaudiet atveidoto HTML priekšskatījuma panelī. Apstipriniet, ka kodu bloki, tabulas un citi sarežģīti elementi parādās, kā paredzēts.
  4. Kopēt vai lejupielādēt: Kopējiet HTML starpliktuvē, lai to ielīmētu SPS, vai saglabājiet kā .html atsevišķai lietošanai. Izvade ir semantiskā HTML5 bez iekļautajiem stiliem.

Bieži lietojami gadījumi

Tehniskās detaļas

Marked izmanto divu cauruļu arhitektūru. Lexer tokenizē ievadi bloka līmeņa marķieros (virsraksti, rindkopas, saraksti, kodu bloki) un iekļautajos marķieros (uzsvars, saites, attēli). Parsētājs staigā pa marķiera straumi un izstaro HTML, katram marķiera veidam piemērojot renderētāja āķus.

Pēc noklusējuma ir iespējoti GitHub aromatizētie Markdown paplašinājumi: tabulas (izmantojot cauruļu sintaksi), norobežoti kodu bloki (trīskārši atzīmes ar valodas norādēm), uzdevumu saraksti (- [ ] un - [x]), pārsvītrojums (izmantojot dubultās tildes) un URL automātiskā saistīšana. Kodu bloki izdala iepriekš apvilktu kodu ar izvēles valodas klasi pakārtotajai sintakses izcelšanai.

Izvades dezinfekcija ir atstāta pakārtoto patērētāju ziņā. Marked izstaro visu, ko rada ievade, tostarp neapstrādātu HTML, kas iegults Markdown. Ja pieņemat neuzticamu ievadi, pirms renderēšanas pārlūkprogrammā palaidiet izvadi, izmantojot DOMpurify vai līdzīgu HTML tīrīšanas līdzekli.

Labākā prakse

Bieži uzdotie jautājumi

Vai MARKDOWN konvertēšana uz HTML maina saturu?
Saturs tiek saglabāts pēc iespējas precīzāk. Tomēr dažiem formātam raksturīgajiem līdzekļiem var nebūt tiešu ekvivalentu, tāpēc var rasties nelielas formatēšanas atšķirības.
Kam tiek izmantots HTML formāts?
HTML (hiperteksta iezīmēšanas valoda) galvenokārt tiek izmantota tīmekļa lapām un tīmekļa saturam.
Vai ir kādi ierobežojumi, kas jāzina?
Tiek atbalstīti faili līdz 50 MB. Ļoti lielu vai sarežģītu failu apstrāde var aizņemt ilgāku laiku. Visas konversijas notiek jūsu pārlūkprogrammā, tāpēc apstrādes ātrums ir atkarīgs no jūsu ierīces.
Vai šī konversija ir droša un privāta?
Jā. Visa apstrāde notiek lokāli jūsu pārlūkprogrammā. Jūsu dati nekad nepamet jūsu ierīci — nav servera augšupielādes, mākoņa apstrādes un datu vākšanas.
Vai emocijzīmes tiek atbalstītas?
Unikoda emocijzīmes iziet cauri tieši (ievadot sirds emocijzīmes, izvadē tiek parādīta sirds). GitHub stila :emoji: īskodi pēc noklusējuma netiek konvertēti; pievienojiet paplašinājumu, ja jums tas ir nepieciešams.
Vai mans Markdown ir augšupielādēts serverī?
Nē. Atzīmēts darbojas jūsu pārlūkprogrammā; reklāmguvums pilnībā notiek jūsu ierīcē.
Vai HTML var pievienot pielāgotu stilu?
Jā, pēc konvertēšanas. Izvade ir vienkāršs semantisks HTML; izmantojiet savu CSS stilu virsrakstiem, kodu blokiem, tabulām un citiem elementiem.
Vai tas atbalsta zemsvītras piezīmes?
Standarta CommonMark nenorāda zemsvītras piezīmju sintaksi. Daži Markdown paplašinājumi atbalsta [^1] zemsvītras piezīmes sintaksi; šis pārveidotājs seko GFM, kas neietver zemsvītras piezīmes.