HTML–Markdown-muunnin

Näin muunnat HTML:n Markdowniksi

1. Valitse suunta: HTML → Markdown tai Markdown → HTML.
2. Liitä koodisi syötekenttään tai napsauta Avaa tiedosto ladataksesi .html-, .htm-, .md- tai .txt-tiedoston tietokoneeltasi (enintään 10 Mt).
3. Säädä asetukset. HTML → Markdownia varten voit valita Otsikot-tyylin, Luettelomerkin ja Koodilohkot-tyylin. Markdown → HTML:ää varten Puhdista HTML (poista skriptit ja tapahtumankäsittelijät) on oletuksena päällä.
4. Napsauta Muunna. Tulos päivittyy myös kirjoittaessasi.
5. Kopioi tai lataa tulos. Vaihda suunta siirtää tuloksen takaisin syötteeksi, jotta voit muuntaa sen toiseen suuntaan ja tarkistaa edestakaisen muunnoksen.

Tuloksen alla oleva Esikatselu näyttää, miltä Markdown näyttää renderöitynä, joten voit tarkistaa muunnoksen yhdellä silmäyksellä.

Mitä HTML → Markdown -muunnos tekee

Muunnin lukee HTML:si selaimen omalla jäsentimellä toimettomassa dokumentissa: skriptit eivät suoritu eikä kuvia ladata. Sen jälkeen se käy läpi sivun rakenteen ja kirjoittaa jokaisen elementin Markdown-vastineen:

• <h1>–<h6> muuttuvat otsikoiksi. ATX (# Otsikko) kirjoittaa #–######. Setext (alleviivattu) alleviivaa tason 1 ja 2 otsikot merkinnällä === tai --- (tasot 3–6 käyttävät aina #-merkkiä).
• <strong> ja <b> muuttuvat muotoon **lihavointi**, <em> ja <i> muotoon _kursiivi_ ja tekstinsisäinen <code> takaheittomerkeiksi.
• Linkit muuttuvat muotoon [teksti](url "otsikko") ja kuvat muotoon ![alt](src).
• Luettelot käyttävät valittua merkkiä (-, * tai +). Numeroidut luettelot säilyttävät start-numeronsa, ja sisäkkäiset luettelot sisennetään.
• <pre><code> muuttuu koodilohkoksi, joko Aitaus (```) tai Sisennetty (4 välilyöntiä).
• <blockquote>, <hr> ja rivinvaihdot muunnetaan myös.
• <script>, <style>, <iframe>, <noscript> ja vastaavat elementit poistetaan sisältöineen.

Merkit, jotka muuten luettaisiin Markdown-syntaksiksi, kuten rivin alussa oleva * tai #, koodataan kenoviivalla, jotta teksti pysyy sellaisenaan.

GitHub Flavored Markdown

Kun GitHub Flavored Markdown (taulukot, ~~yliviivaus~~, tehtävälistat) on valittuna:

• Taulukot muuttuvat pystyviivataulukoiksi tasatuin sarakkein. Otsikko tulee <thead>-riviltä tai riviltä, jossa on vain <th>-soluja. Jos sellaista ei ole, lisätään tyhjä otsikkorivi, koska GFM vaatii sellaisen. Sarakkeiden tasaus luetaan arvoista align="right" tai style="text-align: center". Solujen sisällä olevat pystyviivat koodataan muotoon \|, rivinvaihdot muuttuvat <br>-elementeiksi ja colspan täytetään tyhjillä soluilla. <caption> kirjoitetaan kappaleena taulukon yläpuolelle.
• <del>, <s> ja <strike> muuttuvat muotoon ~~yliviivaus~~.
• Luettelokohtien alussa olevat valintaruudut muuttuvat tehtävälistan kohdiksi: - [x] valmis, - [ ] tehtävä.

Markdownissa ei ole vastinetta sisäkkäisille taulukoille, yhdistetyille riveille tai solujen tyylitykselle. Taulukko, joka sisältää toisen taulukon, säilytetään raakana HTML:nä, jonka useimmat Markdown-renderöijät hyväksyvät. Ilman GFM-valintaa jokainen taulukko säilytetään HTML:nä.

Markdown → HTML

Toiseen suuntaan Markdown renderöidään CommonMark-yhteensopivalla jäsentimellä, ja GFM-laajennukset ovat mukana, kun valinta on päällä. Tuloksena on HTML-katkelmia, valmiina liitettäväksi CMS:ään, sähköpostipohjaan tai verkkosivulle. Kun Puhdista HTML (poista skriptit ja tapahtumankäsittelijät) on valittuna, Markdowniin upotettu raaka HTML puhdistetaan: <script>-tunnisteet, onclick-attribuutit ja javascript:-linkit poistetaan. Poista valinta vain itse kirjoittamallesi Markdownille.