HTML-syöte

Muunnettu Markdown

Esimerkkejä HTML Markdowniksi

Muunna HTML luettavaksi Markdowniksi. Esimerkki:

API-viitekatkelma

HTML-syöte:

Syöte

Muunnettu Markdown:

Tulos

Käytä yllä olevaa Esimerkki-painiketta ladataksesi lisää esimerkkidataa.

Mikä on HTML Markdowniksi?

Markdown on kevyt merkintäkieli dokumentaatioon ja README-tiedostoihin. HTML on puhelias—HTML:n muuntaminen Markdowniksi antaa luettavaa, muokattavaa tekstiä. Tämä työkalu jäsentää HTML:si ja tuottaa Markdownia: otsikoista tulee #, linkeistä [teksti](url), listoista - tai 1.. CommonMark-määrittely määrittelee tulostemuodon.

Muunnos tapahtuu kokonaan selaimessasi. Mitään ei lähetetä palvelimelle. Tulos on siistiä Markdownia. Käänteiseen suuntaan (Markdown HTML:ksi) käytä Markdown HTML:ksi. Muokkaamiseen live-esikatselulla käytä Markdown-editoria.

Miten työkalua käytetään

1

Liitä tai lataa HTML

Kopioi HTML ja liitä se vasempaan editoriin. Voit myös napsauttaa Lataa ja avata .html- tai .htm-tiedoston. Esimerkki-painike lataa esimerkkidataa.

2

Näe Markdown-tulos

Oikea paneeli näyttää muunnetun Markdownin. Otsikot, kappaleet, linkit, kuvat, listat ja taulukot muunnetaan. Monimutkainen HTML voi tuottaa pitkää tai likimääräistä Markdownia.

3

Kopioi tai lataa

Käytä Kopioi tai Lataa. Tuloksen muotoiluun käytä Markdown-muotoilutyökalua. Tarkistukseen Markdown-tarkistinta.

Milloin HTML Markdowniksi auttaa

Kun siirrät sisältöä verkkosivulta, CMS:stä tai WYSIWYG-editorista Markdowniin (esim. GitHub, GitLab tai staattiset sivustot kuten Jekyll), tämä muunnos antaa lähtökohdan. W3C HTML määrittelee syötteen. Kopioi HTML sivulta, liitä tähän ja saat Markdownia, jota voit muokata ja versionhallita.

Sisällön kaapiminen tai vienti tuottaa usein HTML:ää. Markdowniksi muuntaminen tekee siitä muokattavaa pelkkänä tekstinä ja yhteensopivaa dokumentointityökalujen kanssa. Markdownin muuntamiseen HTML:ksi käytä Markdown HTML:ksi. Taulukoiden luontiin datasta käytä Markdown-taulukko-generaattoria.

Usein kysyttyä

Onko muunnos häviötön?

Ei aina. HTML:llä on enemmän rakennetta (divit, spanit, luokat). Markdown on yksinkertaisempi. Monimutkaiset asettelut, sisäkkäiset divit tai inline-tyylit eivät välttämättä vastaa täydellisesti. Tulos on parhaan yrityksen mukainen muunnos.

Onko datani yksityinen?

Kyllä. Muunnos tapahtuu kokonaan selaimessasi. Mitään ei lähetetä palvelimelle.

Entä taulukot?

HTML-taulukot muunnetaan Markdown-taulukkosyntaksiin kun mahdollista. Monimutkaiset taulukot (colspan, rowspan) eivät välttämättä muunnu siististi. Taulukoiden luontiin datasta käytä Markdown-taulukko-generaattoria.

Entä kuvat?

Kuvatageista tulee Markdown-kuvasyntaksi: ![alt](url). Alt-teksti ja URL säilyvät. Suhteelliset URL:t pysyvät ennallaan.

Voinko muuntaa koko HTML-sivun?

Kyllä. Liitä koko sivu. Muunnin poimii tyypillisesti body-sisällön. Skriptit, tyylit ja meta-tagit poistetaan yleensä. Saat pääsisällön Markdownina.

Liittyvät työkalut

Lue lisää: CommonMark, CommonMark-määrittely, GitHub Flavored Markdown, Markdown Guide, MDN HTML, W3C HTML, GitHub.