Convertir HTML a Markdown online

Motivos habituales para pasar de HTML a Markdown

HTML es como se publica el contenido; Markdown es como se escribe y se guarda buena parte de él. La conversión surge al trasladar un blog de WordPress u otro CMS a un generador de sitios estáticos como Hugo, Jekyll o Astro, al copiar documentación de una antigua página de intranet a una wiki basada en Git, al guardar un artículo en una aplicación de notas como Obsidian, o al preparar contenido web como entrada limpia para un script o un índice de búsqueda. Markdown conserva la estructura con significado —títulos, énfasis, enlaces y listas— y descarta el marcado de presentación que hace que el HTML sea difícil de leer y editar.

En qué se convierte cada elemento

La conversión se hace mientras escribes y sigue un conjunto fijo de convenciones, elegidas para coincidir con lo que esperan la mayoría de las herramientas de Markdown:

• De <h1> a <h6> se convierten en títulos de # a ######.
• <strong> y <b> se convierten en **negrita**; <em> e <i> en _cursiva_.
• <a href> se convierte en [texto](url), conservando el atributo title si lo hay. Los enlaces sin href pasan a texto normal.
• <img> se convierte en ![alt](src). El archivo de imagen no se toca, así que el enlace apunta a donde apuntaba el src original.
• Las listas <ul> usan - como viñeta, y las listas <ol> van numeradas.
• <pre><code> se convierte en un bloque de código delimitado por tres comillas invertidas. Una clase como language-python en el elemento de código se conserva como etiqueta de lenguaje del bloque, así que el resaltado de sintaxis sigue funcionando.
• <blockquote> se convierte en líneas que empiezan por >, y <hr> en * * *.
• <br> se convierte en dos espacios al final y un salto de línea, la forma que tiene Markdown de escribir un salto forzado.

Los elementos sin significado en Markdown, como <div>, <span> y <section>, se desenvuelven: su texto se queda y las etiquetas desaparecen. <script>, <style>, <noscript> e <iframe> se eliminan con todo su contenido, lo que se encarga del código de seguimiento, los widgets incrustados y el CSS en línea.

Caracteres que reciben una barra invertida

Puede que veas en el resultado barras invertidas que no estaban en la página, como 1\. Introducción o \*importante\*. Es el escapado, y es correcto. Si un párrafo del HTML empieza por «1.» seguido de un espacio, escribirlo tal cual en Markdown lo convertiría en una lista numerada. Los asteriscos, guiones bajos, corchetes literales y el # al principio de una línea se escapan por el mismo motivo, para que el Markdown renderizado muestre exactamente el texto que mostraba el HTML.

Obtener un resultado limpio a partir de una página web completa

El conversor no adivina qué parte de una página es el artículo. Los menús de navegación, los avisos de cookies, las barras laterales y los pies de página son texto HTML normal, así que pegar el código fuente de una página entera los arrastra todos. Para un resultado limpio, pásale solo el contenido que quieres:

1. Abre la página en tu navegador, haz clic derecho en la primera línea del artículo y elige Inspeccionar.
2. En las herramientas para desarrolladores, busca el elemento que envuelve todo el artículo, a menudo <article> o <main>.
3. Haz clic derecho sobre él, elige Copiar y luego Copiar outerHTML, y pégalo aquí.

Otras cosas que conviene tener en cuenta:

• Los enlaces relativos siguen siendo relativos. Un enlace como /blog/post-2 o una imagen src="img/photo.jpg" se convierten tal como están escritos. Si el Markdown va a vivir en otro sitio, sustitúyelos por URL completas.
• El HTML de los correos se convierte mal. Los boletines se construyen con tablas de maquetación anidadas, y cada <table> se convierte en una tabla de Markdown. El resultado es una única tabla con secciones enteras de texto apretadas en las celdas. Copia el contenido interior de una celda en lugar de todo el correo.
• Las tablas son solo texto. Cada celda se reduce a su texto plano, así que los enlaces y el formato dentro de las celdas se pierden, y la primera fila siempre se convierte en la fila de cabecera.
• Los comentarios HTML se descartan.

Revisar el resultado

La forma más rápida de confirmar una conversión es volver a renderizarla. Pega el Markdown en Markdown a HTML y mira la vista previa: los títulos, las listas y los bloques de código deberían coincidir con la estructura de la página original. Si lo que conviertes es un archivo de Word y no una página web, usa DOCX a Markdown, que aplica las mismas reglas pero lee el .docx directamente. Nada de lo que pegas aquí se sube; tu navegador analiza y convierte el HTML.