Cómo convertir HTML a Markdown y revisar el resultado

Qué puedes convertir de HTML a Markdown

Esta herramienta transforma código HTML proporcionado por ti en texto con formato de estilo Markdown. Puede resultar útil para preparar contenido antes de trasladarlo a un editor que use encabezados, enlaces, listas o bloques de código con esta sintaxis.

La conversión se basa en transformaciones de texto para determinados elementos, atributos, entidades y patrones de espacios. Por eso conviene revisar el resultado cuando el HTML incluye atributos, anidamientos o estructuras poco habituales.

Pasos para convertir el código

1. Copia el fragmento HTML que quieras transformar. El campo de texto es opcional; si lo dejas vacío, la conversión termina correctamente y devuelve un resultado de texto vacío.

2. Pega el contenido en el campo de entrada y ejecuta la conversión.

3. Revisa el texto resultante. Los encabezados del nivel 1 al 6 reciben prefijos de encabezado de Markdown. Los enlaces con el atributo href entre comillas simples o dobles se convierten en enlaces de Markdown, y las imágenes con src entre comillas dobles se convierten en imágenes de Markdown. En las imágenes, el texto alternativo se conserva cuando aparece después de src en la estructura reconocida; en caso contrario, queda vacío.

4. Comprueba el formato en línea y los bloques. Los elementos básicos strong, b, em e i sin atributos pueden convertirse en marcadores de énfasis. La estructura básica <pre><code>...</code></pre> puede pasar a un bloque de código cercado, mientras que los elementos code reconocidos pueden convertirse en código en línea. También se aplican transformaciones de estilo Markdown a ciertos párrafos, saltos de línea, reglas horizontales, listas, citas y contenedores.

5. Corrige manualmente las partes que no hayan quedado como esperabas antes de copiar el resultado. Los bloques script y style se eliminan cuando coinciden con los patrones de apertura y cierre reconocidos, pero un bloque sin cierre o con otra estructura no tiene garantizada la eliminación. Las etiquetas restantes que coincidan con el patrón de eliminación desaparecen, mientras se conserva el texto que contienen.

Cómo leer y revisar el resultado

Interpreta el resultado como una conversión de texto orientada a patrones, no como el análisis de cualquier variante de HTML. La presencia de atributos en elementos de formato, diferencias en el anidamiento o cambios en la estructura pueden impedir que una transformación concreta se aplique. En esos casos, puede quedar texto sin el formato Markdown previsto o desaparecer la sintaxis de etiqueta mientras se mantiene su contenido.

También se descodifica un conjunto definido de entidades con nombre y referencias numéricas decimales. Las referencias con dígitos en la forma &#dígitos; se procesan mediante la conversión de caracteres; una cifra fuera del intervalo válido puede provocar un error. Otras formas mal construidas pueden permanecer sin cambios.

Por último, se reducen a tres los grupos de cuatro o más saltos de línea y se eliminan los espacios en blanco del principio y del final. Usa la salida como base revisable, especialmente si el fragmento combina estructuras HTML variadas.

Ejemplo práctico

Una persona recibe un fragmento con un encabezado, un enlace y un elemento de código en línea, y quiere prepararlo para un editor basado en Markdown.

Pega el fragmento, ejecuta la conversión y comprueba que esos tres tipos de contenido aparecen con sintaxis de estilo Markdown.

El resultado tiene forma de texto Markdown: un encabezado con prefijo, un enlace con texto y destino, y una línea de código en línea.

Limitaciones

• La conversión está limitada a patrones concretos de etiquetas, atributos, estructuras y entidades. Algunas variantes pueden no transformarse; una referencia numérica decimal formada solo por dígitos pero fuera del intervalo válido puede provocar un error.

Errores frecuentes

• Un error frecuente es esperar que una etiqueta con atributos o una estructura anidada reciba la misma conversión que una forma básica reconocida. Comprueba la sintaxis del resultado y ajusta manualmente el HTML o el Markdown cuando esa variante no coincida con los patrones admitidos.

Preguntas frecuentes

¿Qué ocurre si no introduzco HTML?

Sí, si el campo se deja vacío o se omite, la operación termina correctamente y devuelve un resultado de texto vacío.

¿Cómo se convierten las imágenes HTML?

Puede convertirse cuando la imagen usa src entre comillas dobles. El texto alternativo se utiliza si aparece después de src en la estructura reconocida; si no, la imagen queda con texto alternativo vacío.

¿La herramienta convierte cualquier HTML?

No necesariamente. Las formas con atributos, anidamientos o estructuras distintas pueden no coincidir con las transformaciones disponibles. Revisa y corrige el resultado después de la conversión.