HTML a Markdown

Cómo funciona

Markdown es lo que quieren los archivos README, los gestores de incidencias, las wikis y los sitios estáticos. HTML es lo que obtienes al copiar de una página web o exportar desde un CMS. Convertir de uno a otro a mano es tedioso y el resultado suele estar lleno de marcado sobrante.

Qué se convierte limpiamente

Encabezados, párrafos, negrita y cursiva, enlaces, imágenes, código en línea, bloques de código, citas, reglas horizontales y los dos tipos de lista, incluidas las anidadas. Tienen equivalentes exactos en Markdown y salen como los escribirías a mano.

Qué no puede sobrevivir

Markdown no tiene forma de expresar estilos, clases, divs de maquetación, spans ni nada visual. Esas etiquetas se desenvuelven: se conserva su texto y se descarta la etiqueta en sí, y se informa del recuento para que sepas que algo se simplificó. Los scripts y los bloques de estilo se eliminan por completo.

Tablas

El texto de las tablas se conserva, pero no se representa como tabla Markdown, porque las tablas HTML suelen usar celdas combinadas y anidamiento que la sintaxis de tablas de Markdown realmente no puede representar. Es más rápido volver a marcar a mano las tablas simples que recibirlas destrozadas.

Analizado, no buscado por patrones

El HTML lo analiza el propio analizador de tu navegador en lugar de procesarse con expresiones regulares, así que el marcado mal formado y muy anidado se trata como lo trataría un navegador.