Convertidor de Markdown a HTML
También de HTML a Markdown, viendo el resultado al momento

Lo que ofrece este convertidor de Markdown a HTML

Este convertidor de Markdown a HTML transforma el Markdown de texto plano en el HTML que necesita una página web. Escribe en el cuadro de Markdown y el HTML aparece en el otro, mientras una vista previa debajo muestra cómo quedará.

Además, funciona al revés. Pega HTML de una página web, un CMS o un correo, y obtienes Markdown limpio para un README, un sitio estático o una app de notas.

Todo ocurre en tu navegador, así que los borradores, las notas privadas y los documentos de clientes nunca salen de tu dispositivo. Además, la vista previa es segura, porque el convertidor desactiva cualquier script o enlace peligroso antes de mostrarte el resultado.

Qué es Markdown

Markdown da formato a un texto con signos de teclado corrientes, como asteriscos y almohadillas. Un # inicia un título, los asteriscos ponen el texto en negrita o cursiva, y un guion inicia un elemento de lista. Por eso, el texto sigue siendo fácil de leer incluso antes de convertirlo.

John Gruber lo creó en 2004, y su historia y sus variantes están documentadas en detalle. Hoy, además, impulsa GitHub, Reddit, Slack, Notion, Jekyll, Hugo e innumerables sitios de documentación.

Convertir Markdown a HTML

Escribe o pega Markdown en el primer cuadro. El HTML se actualiza mientras escribes, con títulos, párrafos, listas, enlaces, imágenes, citas y bloques de código en su sitio. Después cópialo o descárgalo como archivo .html.

Los bloques de código conservan su lenguaje, así que ```js se convierte en un elemento code con la clase language-js. Justo eso buscan los resaltadores de sintaxis como Prism y highlight.js.

Convertir HTML a Markdown

Pega HTML en el segundo cuadro y el Markdown aparece en el primero. El convertidor conserva títulos, negrita y cursiva, enlaces, imágenes, listas, citas, código y tablas. Mientras tanto, descarta scripts, estilos y marcos incrustados, que no tienen sitio en Markdown.

Puedes elegir un guion o un asterisco para los elementos de lista, y almohadillas o subrayados para los títulos principales. Así, el resultado coincide con el estilo que ya usa tu proyecto.

Tablas de GitHub, listas de tareas y más

Con los extras de GitHub activados, el convertidor entiende las funciones que la gente usa a diario en GitHub. Es decir, tablas con alineación de columnas, listas de tareas con casillas, tachado con doble virgulilla y direcciones web sueltas que se convierten solas en enlaces.

Estos extras siguen GitHub Flavored Markdown, el dialecto que GitHub detalla en su propia guía de sintaxis de escritura y formato. En cambio, si necesitas Markdown estricto y simple, desactívalos.

Qué reglas de Markdown sigue

Las reglas básicas vienen de la especificación CommonMark, el estándar que comparten casi todas las herramientas modernas, que el IETF registró junto con los demás dialectos en RFC 7764. Eso cubre los casos comunes: títulos, énfasis, enlaces, enlaces de referencia, listas, listas anidadas, citas y código. Sin embargo, algunos casos raros de la especificación completa pueden variar un poco.

Seguro para pegar cualquier cosa

Markdown puede contener HTML sin procesar, y por ahí atacan a muchos sitios. Por eso, de forma predeterminada, este convertidor muestra las etiquetas HTML dentro de Markdown como texto plano. Si confías en la fuente, marca Permitir etiquetas HTML sin procesar, y el convertidor conserva las etiquetas pero quita scripts, marcos y manejadores de eventos.

En cualquier caso, el convertidor revisa cada enlace. Un enlace a javascript: o a un esquema parecido se vuelve un # inofensivo, y la tabla de comprobaciones te dice cuántos cambió.

Comprobaciones que detectan fallos comunes

Debajo de la vista previa, una tabla de comprobaciones revisa el resultado. Avisa cuando saltas un nivel de título, por ejemplo un H2 seguido de un H4, lo que confunde a los lectores de pantalla y a los buscadores. Además, señala imágenes sin texto alternativo y páginas con más de un H1.

Para revisar a fondo los títulos de una página publicada, nuestro analizador de etiquetas de encabezado lee cualquier URL y muestra su esquema.

Markdown para archivos README

Casi todos los proyectos de GitHub empiezan con un archivo README.md. Así que, si tu documentación vive en una vieja página HTML, pégala en el cuadro de HTML, copia el Markdown y tu README estará listo en segundos.

Pega HTML y obtendrás Markdown limpio. Por ejemplo, cuando un cliente quiere el README como página web, convierte el Markdown a HTML y colócalo en cualquier plantilla.

Markdown en generadores de sitios estáticos

Jekyll, Hugo, Eleventy, Astro y Docusaurus construyen sitios web a partir de archivos Markdown. Por lo tanto, mudar un sitio antiguo a uno de ellos suele exigir convertir antes muchas páginas HTML a Markdown, y este convertidor lo hace página a página.

Antes de confirmar los archivos, mira la tabla de comprobaciones. Señala niveles de título saltados e imágenes sin texto alternativo, dos fallos que un sitio estático publicaría tal cual.

Pegar desde Word o Google Docs y perder el formato

Copiar desde Word o Google Docs suele arrastrar mucho estilo oculto. Primero pega el texto en tu CMS o en un borrador de correo, luego copia el HTML y pégalo aquí. El convertidor conserva la estructura, como títulos, listas y enlaces, y deja atrás las fuentes y los colores.

De este modo, obtienes Markdown limpio que puedes guardar, editar y reutilizar donde quieras, sin el desorden que añaden las herramientas de oficina.

Negritas con **asteriscos**, sin menús

Muchos autores prefieren Markdown porque nunca necesitan tocar el ratón. En lugar de pulsar una barra de herramientas, escribes dos asteriscos para la negrita o una almohadilla para un título, y no pierdes el hilo. Después, esta página convierte el borrador en HTML en un solo paso. Mientras tanto, las notas originales siguen legibles en cualquier editor de texto plano, incluso dentro de muchos años.

Trucos para que las tablas salgan bien

Una tabla necesita dos cosas: una fila de cabecera y, justo debajo, una fila de guiones entre barras verticales. Sin esa fila divisoria, el convertidor lee las líneas como texto plano, así que la tabla nunca aparece.

Las demás filas pueden quedar desiguales, porque el convertidor alinea las celdas por ti. Además, dos puntos a cualquier lado de los guiones fijan la alineación de la columna, y la vista previa la muestra al instante.

Por último, mantén cada tabla sencilla. Markdown no permite combinar celdas, así que, si un diseño lo necesita, deja la tabla en HTML dentro de tu página.

Sitios donde se escribe en Markdown

Los redactores escriben en Markdown y pegan el HTML en un CMS sin soporte para Markdown. Los desarrolladores pasan documentación HTML antigua a un sitio en Markdown. Por su parte, los equipos de soporte convierten páginas de ayuda en una base de conocimiento, y los estudiantes limpian apuntes copiados de la web.

En cada caso, el diseño en dos sentidos ahorra tiempo. Puedes convertir, editar el Markdown y volver a convertir, sin reescribir nada.

Consejos para un Markdown limpio

Deja una línea en blanco entre bloques, por ejemplo antes de una lista o después de un título. Sangra los elementos anidados con dos o cuatro espacios, y encierra el código entre tres acentos graves en lugar de sangrarlo. Además, da a cada imagen una breve descripción entre los corchetes.

Cuando termines, cuenta las palabras con nuestro contador de palabras, o revisa el título y la descripción de la página con la vista previa del fragmento SERP.