Convertir HTML a Markdown

Por qué convertir HTML a Markdown

El HTML es extenso y difícil de editar a mano, mientras que el Markdown se lee casi como texto plano. Pasar el contenido a Markdown facilita guardarlo en Git, editarlo en apps de notas como Obsidian o publicarlo con generadores de sitios estáticos como Hugo, Jekyll, Astro y Docusaurus.

Este conversor usa Turndown, una biblioteca madura de conversión de HTML a Markdown, con ajustes sensatos: títulos con #, bloques de código delimitados, viñetas con guion y énfasis con asteriscos. También convierte las tablas al formato de GitHub y elimina scripts, estilos y marcos incrustados, para que obtengas el contenido y no la fontanería de la página.

HTML frente a Markdown: comparación rápida

Cómo convertir HTML a Markdown

1. 1

   Paso 1: Consigue el archivo HTML

   Guarda una página web como .html, exporta un correo o una entrada del CMS, o guarda un fragmento en un archivo .html.

2. 2

   Paso 2: Suéltalo en el conversor

   El archivo lo analiza el propio analizador HTML de tu navegador.

3. 3

   Paso 3: Convierte a Markdown

   Se eliminan la cabecera, los scripts y los estilos, y el body se convierte elemento a elemento.

4. 4

   Paso 4: Descarga el archivo .md

   Ábrelo en tu editor o súbelo a tu repositorio.

Qué se convierte

Conversiones de HTML a Markdown habituales

• Migrar un blog. Lleva tus entradas de WordPress u otro CMS a un sitio basado en Markdown.

• Guardar artículos en tus notas. Conserva copias legibles de páginas web en Obsidian o Logseq.

• Escribir documentación. Convierte páginas de ayuda HTML antiguas en documentación versionada.

• Preparar texto para IA. El Markdown conserva la estructura y elimina el ruido del HTML.

Qué se elimina o se simplifica

Markdown no tiene maquetación, colores ni clases, así que el estilo desaparece. Scripts, hojas de estilo, bloques noscript, plantillas, iframes y todo el contenido del head se eliminan por completo. Los menús de navegación y pies que forman parte del body seguirán apareciendo, así que en páginas web quizá quieras recortarlos después.

Las tablas complejas con celdas combinadas no pueden representarse con tablas de barras. Su contenido se conserva celda a celda, pero la combinación se aplana.

Enlaces e imágenes

Los enlaces se escriben como [texto](url) y las imágenes como , con las URL exactamente como aparecen en el HTML. Las URL relativas como /images/foto.jpg siguen siendo relativas, así que solo funcionan si el Markdown vive en un sitio con la misma estructura.

Los caracteres con significado en Markdown, como asteriscos y guiones bajos en el texto normal, se escapan con barras invertidas para que el documento se vea como el original.

• Las URL absolutas funcionan en cualquier sitio.
• Las URL relativas necesitan la misma estructura de carpetas.
• El texto alternativo se conserva por accesibilidad.

Consejos para obtener Markdown limpio

• Guarda solo la parte del artículo cuando puedas; el modo lectura del navegador ayuda.
• Busca y reemplaza los restos de navegación después de convertir páginas completas.
• Revisa las tablas con celdas combinadas y rehazlas a mano si hace falta.
• Usa HTML a TXT si solo quieres las palabras sin ningún marcado.

Preguntas sobre la conversión de HTML a Markdown