Convertidor de Markdown a HTML

El Convertidor de Markdown a HTML es una herramienta gratuita que transforma fragmentos de Markdown en código HTML sin procesar para usarlo en sitios web, sistemas de gestión de contenidos y flujos de trabajo de desarrollo.

¿Qué convierte esta herramienta?

Convierte el formato Markdown en los elementos HTML correspondientes. Un encabezado se transforma en un elemento de encabezado, un enlace en un elemento de anclaje y una lista con viñetas en una lista desordenada que contiene elementos de lista.

Markdown es un formato de marcado de texto plano que se utiliza habitualmente en archivos README, documentación técnica, descripciones de incidencias y contenido para sitios estáticos. Convertirlo a HTML resulta útil cuando el destino requiere HTML en lugar de Markdown, por ejemplo, una plantilla web, un sistema de correo electrónico o un campo de un sistema de gestión de contenidos.

Markdown tiene varios dialectos. CommonMark, GitHub Flavored Markdown y los analizadores específicos de cada aplicación pueden tratar de forma distinta las tablas, las listas de tareas, los saltos de línea y el HTML incrustado. La información disponible sobre la herramienta no especifica ningún dialecto concreto, así que comprueba la sintaxis que vaya más allá de los encabezados, párrafos, enlaces y listas habituales antes de usar el resultado.

¿Cómo convierto Markdown a HTML?

Introduce el texto de origen en el campo Markdown, ejecuta la conversión y consulta o copia el código generado en el campo HTML.

1. Pega un fragmento completo, no una marca de formato aislada.
2. Convierte el texto y revisa la estructura de elementos del HTML obtenido.
3. Comprueba los enlaces, las listas anidadas y los bloques de código en la aplicación que los mostrará.
4. Aplica los estilos del sitio por separado si el destino aún no dispone de un CSS adecuado.

La conversión se realiza en el servidor. El contenido introducido se envía al servidor mediante HTTPS y no se almacena. Como el texto sale de tu dispositivo para procesarse, no envíes credenciales, claves privadas ni material confidencial si la política de tu organización prohíbe usar herramientas que procesen datos en el servidor.

¿Cómo interpreto el HTML obtenido?

Interpreta el resultado como código HTML sin procesar, compuesto por elementos que representan la estructura del Markdown. Puede servir para insertarlo en una página, una plantilla o un campo de contenido existentes, pero no tiene por qué ser un documento HTML completo con doctype, metadatos, estilos y scripts.

Este es un ejemplo sencillo de encabezado en texto plano:

# Release notes

El resultado HTML convencional es:

<h1>Release notes</h1>

Este es un ejemplo de lista breve:

- Alpha

- Beta

La estructura correspondiente es una lista desordenada con dos elementos de lista:

<ul>

<li>Alpha</li>

<li>Beta</li>

</ul>

La mayoría de los errores de Markdown no generan errores formales del analizador. Una marca de formato sin cerrar, una sangría incorrecta o la ausencia de un espacio tras una marca de lista pueden aparecer simplemente como texto normal. Si el HTML obtenido parece válido, pero su estructura es incorrecta, compara los elementos de salida con la jerarquía prevista del documento.

• Comprueba que los encabezados tengan el nivel esperado y no salten innecesariamente de uno a otro.
• Confirma que los elementos de las listas anidadas mantengan una sangría coherente en el Markdown de origen.
• Revisa los destinos de los enlaces antes de publicar, sobre todo si procesas contenido de terceros.
• Examina con atención los bloques de código delimitados, ya que un delimitador sin cerrar puede incluir el resto del documento.
• Busca HTML sin procesar en el contenido de origen, pues las distintas implementaciones de Markdown pueden conservarlo, escaparlo o rechazarlo.

Detalles prácticos de la conversión

La conversión de Markdown modifica la estructura, no el idioma del texto. Las letras acentuadas, los sistemas de escritura no latinos, los números y los signos de puntuación habituales pueden mantenerse como contenido textual dentro de los elementos generados. Los caracteres con significado especial en HTML pueden requerir codificación como entidades cuando deban mostrarse literalmente en lugar de formar parte del marcado.

Los espacios y las líneas en blanco pueden afectar al análisis. Por lo general, una línea en blanco separa párrafos, mientras que la sangría puede crear una lista anidada o un bloque de código. El tratamiento de los saltos de línea también varía entre dialectos de Markdown, por lo que un solo salto de línea en el contenido de origen no siempre produce un salto de línea visible en HTML.

Una entrada vacía no contiene una estructura documental significativa que se pueda convertir. Para entradas muy largas, puede ser mejor utilizar un proceso de compilación local, donde sea posible controlar las versiones, realizar pruebas y convertir el contenido de forma coherente con el mismo analizador que se usa en producción. Ningún convertidor puede determinar si un nivel de encabezado, el destino de un enlace o la jerarquía de una lista son semánticamente correctos para tu proyecto.

¿Cuándo merece la pena convertir Markdown a HTML?

Merece la pena convertir Markdown a HTML cuando el sistema de destino acepta HTML, pero el contenido de origen está escrito o se proporciona en Markdown. Algunos casos habituales son revisar documentación de terceros antes de importarla, depurar la compilación de un sitio estático, preparar notas de una versión para un editor que solo admite HTML o comprobar el marcado generado antes de implementarlo.

Normalmente, no merece la pena convertir Markdown a HTML si el contenido solo lo leerá una máquina y el Markdown ya funciona en el formato requerido. Del mismo modo, convertirlo a HTML demasiado pronto en un flujo de trabajo puede dificultar las ediciones posteriores si los autores deben seguir trabajando en Markdown.

No minimices el HTML mientras depuras su estructura. Un marcado legible permite detectar con mayor facilidad elementos anidados en posiciones incorrectas o elementos inesperados. Una vez revisado el resultado y preparado para su uso en producción, el Minificador de HTML puede reducir los espacios en blanco innecesarios.

Preguntas frecuentes

¿El HTML convertido incluye estilos CSS?

El HTML describe la estructura, mientras que CSS controla la mayor parte de la presentación. Un elemento de encabezado puede verse distinto en cada sitio porque el navegador, la aplicación o el tema aportan los estilos. Añade o reutiliza CSS en el destino, en lugar de esperar que el Markdown de origen defina la apariencia final.

¿Puedo convertir tablas y listas de tareas de Markdown?

La compatibilidad depende del dialecto de Markdown que utilice el analizador. Las tablas y las casillas de las listas de tareas son extensiones habituales, pero no forman parte de la sintaxis universal de Markdown. Convierte una muestra pequeña y representativa, y verifica los elementos devueltos antes de usarlos en un documento más extenso.

¿Es seguro convertir Markdown que no es de confianza?

Trata el Markdown que no sea de confianza como contenido no fiable incluso después de convertirlo. Según el analizador y el destino, puede ser necesario sanear el HTML incrustado o los esquemas de enlaces no seguros. Este convertidor cambia el formato, pero la conversión por sí sola no debe considerarse un filtro de seguridad.

¿Puedo pegar el HTML en WordPress o en otro CMS?

Por lo general, sí, siempre que el editor disponga de una vista HTML o de código y permita los elementos obtenidos. Algunos sistemas de gestión de contenidos sanean el marcado pegado, eliminan atributos no admitidos o modifican el espaciado entre párrafos. Previsualiza el contenido y revisa la versión guardada, ya que el CMS puede transformarlo después del envío.

¿Por qué mi bloque de código se muestra incorrectamente?

Comprueba que los delimitadores de apertura y cierre coincidan y aparezcan en líneas separadas. Los bloques de código con sangría también pueden dejar de interpretarse correctamente si la sangría de las listas que los rodean no es coherente. Si necesitas resaltado de sintaxis, el destino debe reconocer cualquier identificador de lenguaje y aportar su propio script o sus propios estilos de resaltado.

¿Debo conservar el Markdown después de convertirlo?

Conserva el Markdown cuando sea la fuente editable de referencia. Guarda el HTML generado por separado o vuelve a crearlo durante la compilación para evitar que las modificaciones posteriores diverjan entre ambos formatos. Antes de publicar, valida los enlaces y revisa el fragmento en su destino real, en lugar de confiar únicamente en el código sin procesar.