Ilmainen muunnin

Merkintä arvoon HTML-muunnin

Muunna Markdown-teksti tuotantovalmiiksi HTML-koodiksi live-esikatselun tuella.

Tietoa tästä työkalusta

Markdown on John Gruberin vuonna 2004 luoma kevyt merkintäkieli, jonka avulla kirjoittajat voivat tuottaa strukturoitua HTML-koodia pelkän tekstin käytäntöjen avulla: otsikoiden hash-merkit, korostukset tähdet, luettelot yhdysmerkit ja koodin sisennetyt lohkot. Muoto on tullut oletusasetukseksi README-tiedostoille, tekniselle dokumentaatiolle, blogiluonnoksille, staattisille sivuston luojille ja kaikille konteksteille, joissa tekstin pitäisi olla luettavissa pelkkänä tekstinä ja renderöitynä tulosteena. Markdownin muuntaminen HTML:ksi on renderöintivaihe, joka muuttaa lähteen verkkosivuksi.

Tämä muunnin käyttää merkittyä kirjastoa, JavaScriptin laajimmin käytettyä Markdown-renderöijää. Marked tukee CommonMarkia ja GitHub Flavored Markdownia (GFM), mikä tarkoittaa, että taulukot, aidatut koodilohkot, tehtäväluettelot, yliviivaukset ja automaattinen linkitys toimivat oikein normaalien Markdown-ominaisuuksien lisäksi.

Tulostus on tavallista HTML:ää – semanttiset tunnisteet otsikoille, kappaleille, luetteloille, linkeille ja kuville sekä luokkakoukut koodilohkoille, joissa syntaksin korostustyökalut niitä odottavat. Tulostusliitä selkeästi mihin tahansa sisällönhallintajärjestelmään, upotetaan staattisiin sivustogeneraattoreihin tai toimii erillisenä .html-tiedostona. CSS:ää tai JavaScriptiä ei ole lisätty; tuloksen muotoilu jätetään loppupään kontekstiisi.

Miksi muuntaa Markdown HTML-muotoon

Markdown on kirjoittajien ja kehittäjien suosima muoto; HTML on selaimen muotoilema muoto. Useimmat staattiset sivustogeneraattorit ja CMS-alustat muuntavat Markdownin HTML:ksi kulissien takana, mutta joskus tarvitset muuntamisen itsenäisenä vaiheena – liittäminen CMS:ään, jossa ei ole Markdown-tukea, HTML-koodin luominen sähköposteille, nopea esikatselu tai renderoidun tulosteen purkaminen jatkokäsittelyä varten.

HTML on myös kanoninen muoto kaikille selaimessa näytettävälle sisällölle. Markdown-luonnoksia sisältävät sähköpostiuutiskirjeet, suurempiin HTML-sovelluksiin upotetut dokumentaatiosivut ja HTML-koodia odottaviin muokkausohjelmiin liitetyt blogiviestit hyötyvät puhtaasta muunnoksesta.

Käyttöohjeet

Liitä Markdown, hanki HTML.

  1. Lisää merkintäsi: Liitä Markdown-teksti syöttöalueelle tai pudota .md-tiedosto. Sekä tavallinen Markdown- että GitHub Flavored Markdown -syntaksi toimivat.
  2. Muunna: Marked jäsentää Markdownin AST:ksi ja lähettää HTML:n. Vakioelementit (korostus, vahva, linkit, koodi, kuvat), lohkoelementit (otsikot, kappaleet, luettelot, lainausmerkit) ja GFM-laajennukset (taulukot, aidattu koodi, tehtäväluettelot, automaattiset linkit) renderöivät kaikki oikein.
  3. Esikatselu: Tarkista hahmonnettu HTML esikatselupaneelissa. Varmista, että koodilohkot, taulukot ja muut monimutkaiset elementit näkyvät odotetulla tavalla.
  4. Kopioi tai lataa: Kopioi HTML leikepöydälle liittämistä varten sisällönhallintajärjestelmään tai tallenna .html-muodossa itsenäistä käyttöä varten. Tulos on semanttinen HTML5 ilman sisäisiä tyylejä.

Yleiset käyttötapaukset

Tekniset tiedot

Marked käyttää kaksivaiheista arkkitehtuuria. Lexer tokenisoi syötteen lohkotason tunnuksiksi (otsikot, kappaleet, luettelot, koodilohkot) ja inline-tunnisteiksi (korostus, linkit, kuvat). Jäsentäjä kulkee merkkivirtaa pitkin ja lähettää HTML-koodia soveltaen renderöintikoukkuja jokaiselle merkkityypille.

GitHub Flavoured Markdown -laajennukset ovat oletusarvoisesti käytössä: taulukot (käyttämällä putkisyntaksia), aidatut koodilohkot (kolminkertaiset kielivihjeet), tehtäväluettelot (- [ ] ja - [x]), yliviivaus (käyttäen kaksoistiltoja) ja URL-osoitteiden automaattinen linkitys. Koodilohkot lähettävät valmiiksi käärittyä koodia valinnaisella kieliluokalla syntaksin korostamista varten.

Tuotoksen desinfiointi jätetään jatkokuluttajien tehtäväksi. Marked lähettää mitä tahansa syötettä, mukaan lukien Markdowniin upotettu raaka-HTML. Jos hyväksyt epäluotettavan syötteen, suorita tulos DOMpurifyn tai vastaavan HTML-puhdistusohjelman kautta ennen kuin renderöit sen selaimessa.

Parhaat käytännöt

Usein kysytyt kysymykset

Muuttaako MARKDOWNin muuntaminen HTML:ksi sisältöä?
Sisältö säilytetään mahdollisimman tarkasti. Joillakin muotokohtaisilla ominaisuuksilla ei kuitenkaan välttämättä ole suoria vastineita, joten pieniä muotoilueroja voi esiintyä.
Mihin HTML-muotoa käytetään?
HTML:ää (HyperText Markup Language) käytetään ensisijaisesti verkkosivuille ja verkkosisällölle.
Onko olemassa mitään rajoituksia, jotka on tiedostettava?
50 Mt:n tiedostot ovat tuettuja. Erittäin suurten tai monimutkaisten tiedostojen käsittely voi kestää kauemmin. Kaikki muunnos tapahtuu selaimessasi, joten käsittelynopeus riippuu laitteestasi.
Onko tämä muunnos turvallinen ja yksityinen?
Kyllä. Kaikki käsittely tapahtuu paikallisesti selaimessasi. Tietosi eivät koskaan poistu laitteestasi – ei palvelimelle latausta, ei pilvikäsittelyä, ei tiedonkeruuta.
Ovatko emojit tuetut?
Unicode-emojit kulkevat suoraan läpi (sydänemojin kirjoittaminen näyttää sydämen tulosteessa). GitHub-tyylinen :emoji: lyhytkoodeja ei muunneta oletuksena; lisää laajennus, jos tarvitset sitä.
Onko Markdowni ladattu palvelimelle?
Ei. Marked toimii selaimessasi; muunnos tapahtuu kokonaan laitteellasi.
Voinko lisätä mukautettua tyyliä HTML-koodiin?
Kyllä, muuntamisen jälkeen. Tulos on tavallinen semanttinen HTML; soveltaa omaa CSS:ääsi tyyliotsikoille, koodilohkoille, taulukoille ja muille elementeille.
Tukeeko se alaviitteitä?
Tavallinen CommonMark ei määritä alaviittesyntaksia. Jotkut Markdown-laajennukset tukevat [^1] alaviittesyntaksia; tämä muunnin noudattaa GFM:ää, joka ei sisällä alaviitteitä.