Convertidor d'HTML a Markdown

Com convertir HTML a Markdown

1. Tria la direcció: HTML → Markdown o Markdown → HTML.
2. Enganxa el codi al quadre d’entrada, o fes clic a Obre un fitxer per carregar un fitxer .html, .htm, .md o .txt del teu ordinador (fins a 10 MB).
3. Ajusta les opcions. Per a HTML → Markdown pots triar l’estil dels Encapçalaments, el Marcador de llista i l’estil dels Blocs de codi. Per a Markdown → HTML, Neteja l’HTML (elimina scripts i controladors d’esdeveniments) està activat per defecte.
4. Fes clic a Converteix. El resultat també s’actualitza mentre escrius.
5. Copia o baixa el resultat. Inverteix la direcció mou el resultat de nou a l’entrada perquè el puguis convertir en sentit contrari i comprovar l’anada i tornada.

La Previsualització que hi ha sota el resultat mostra com es renderitza el Markdown, de manera que pots comprovar la conversió d’un cop d’ull.

Què fa la conversió d’HTML a Markdown

El convertidor llegeix el teu HTML amb l’analitzador del mateix navegador, en un document inert: els scripts no s’executen i les imatges no es baixen. Després recorre l’estructura de la pàgina i escriu l’equivalent en Markdown de cada element:

• <h1> a <h6> es converteixen en encapçalaments. ATX (# Títol) escriu de # a ######; Setext (subratllat) subratlla els encapçalaments de nivell 1 i 2 amb === o --- (els nivells 3 a 6 sempre fan servir #).
• <strong> i <b> es converteixen en **negreta**, <em> i <i> en _cursiva_, i el <code> en línia en accents oberts.
• Els enllaços es converteixen en [text](url "títol") i les imatges en ![alt](src).
• Les llistes fan servir el marcador triat (-, * o +); les llistes ordenades conserven el seu número start, i les llistes imbricades es sagnen.
• <pre><code> es converteix en un bloc de codi, Amb tanques (```) o Sagnats (4 espais).
• <blockquote>, <hr> i els salts de línia també es converteixen.
• <script>, <style>, <iframe>, <noscript> i elements semblants s’eliminen amb el seu contingut.

Els caràcters que altrament es llegirien com a sintaxi de Markdown, com un * o un # a l’inici d’una línia, s’escapen amb una barra inversa perquè el text es mantingui literal.

GitHub Flavored Markdown

Amb GitHub Flavored Markdown (taules, ~~text ratllat~~, llistes de tasques) marcat:

• Les taules es converteixen en taules amb barres verticals amb les columnes alineades. La capçalera ve d’una fila <thead> o d’una fila formada només per cel·les <th>; si no n’hi ha cap, s’afegeix una fila de capçalera buida, perquè GFM n’exigeix una. L’alineació de les columnes es llegeix d’align="right" o de style="text-align: center". Les barres verticals dins de les cel·les s’escapen com a \|, els salts de línia es converteixen en <br> i un colspan s’emplena amb cel·les buides. Un <caption> s’escriu com un paràgraf damunt de la taula.
• <del>, <s> i <strike> es converteixen en ~~text ratllat~~.
• Les caselles de selecció a l’inici dels elements de llista es converteixen en elements de llista de tasques: - [x] fet, - [ ] pendent.

Markdown no té equivalent per a les taules imbricades, les files combinades ni els estils de cel·la. Una taula que en conté una altra es conserva com a HTML en brut, que la majoria de renderitzadors de Markdown accepten. Sense l’opció GFM, totes les taules es conserven com a HTML.

De Markdown a HTML

En l’altra direcció, el Markdown es renderitza amb un analitzador compatible amb CommonMark, amb les extensions GFM quan l’opció està activada. La sortida són fragments d’HTML, a punt per enganxar en un CMS, una plantilla de correu electrònic o una pàgina web. Quan Neteja l’HTML (elimina scripts i controladors d’esdeveniments) està marcat, l’HTML en brut incrustat al Markdown es neteja: les etiquetes <script>, els atributs onclick i els enllaços javascript: s’eliminen. Desmarca-ho només per al Markdown que hagis escrit tu mateix.