Cómo convertir Markdown a HTML
- Pega tu Markdown (un README, un conjunto de notas, un borrador de blog, documentación) en la caja de arriba.
- Opcionalmente activa Convertir saltos de línea simples en
<br>si quieres que cada salto de línea de tu texto original se convierta en un salto de línea real en el HTML (desactivado por defecto, coincidiendo con el comportamiento estándar de Markdown/GFM). - Haz clic en Convertir, el código fuente HTML saneado aparece instantáneamente, justo debajo.
- Haz clic en Copiar al portapapeles para pegarlo directamente en un sitio estático, un campo de CMS, el cuerpo HTML de un email o un archivo
.html, o selecciona el texto y guárdalo tú mismo como archivo.html.
Sin archivo que subir, pega tu Markdown y obtén HTML real y seguro de vuelta en la misma pestaña.
Por qué convertir Markdown a HTML
Markdown es el formato en el que casi todo desarrollador y redactor técnico escribe primero: READMEs, issues de GitHub, sitios de documentación, exportaciones de Notion, contenido de generadores de sitios estáticos, mensajes de Slack/Discord. Pero en el momento en que ese contenido necesita vivir en algún sitio que solo entiende HTML, un campo de CMS old-school, una plantilla de email hecha a mano, una página estática simple sin paso de build, un <div> en el que estás pegando contenido directamente, necesitas el marcado HTML realmente renderizado, no el código fuente Markdown. Escribir ese HTML a mano (envolviendo cada encabezado en <h1>–<h6>, cada elemento de lista en <li>, cada bloque de código en <pre><code>) es exactamente el tipo de trabajo repetitivo y propenso a errores que Markdown existe para evitar en primer lugar.
Esta herramienta pasa tu Markdown por marked, un analizador rápido y conforme a la especificación con soporte de GitHub Flavored Markdown (tablas, listas de tareas, tachado, URLs autoenlazadas) integrado, así que un README con una tabla comparativa o una lista de verificación se convierte tan limpiamente como un simple párrafo de prosa.
Saneado por diseño, no como algo añadido después
Los analizadores de Markdown están comúnmente diseñados para dejar pasar directamente el HTML en bruto de tu texto original, eso es una característica deliberada y documentada (así es como incrustas una etiqueta <video> o ajustas el espaciado dentro de Markdown por lo demás plano), no un error. Pero también significa que una etiqueta <script> perdida, un <img onerror="...">, o una URL javascript: dentro de un enlace (escrita por ti, copiada y pegada de algún sitio no fiable, o plantada por otra persona en un documento compartido) se convertiría en HTML que puede realmente ejecutar código en el instante en que se renderiza en un navegador o se abre desde un archivo descargado.
Por eso cada conversión aquí pasa la salida en bruto del analizador por DOMPurify, un saneador de HTML centrado en la seguridad usado en toda la industria, antes de que veas jamás el resultado. Las etiquetas <script> se eliminan por completo, los atributos de manejador de eventos (onerror, onclick, onload, …) se quitan de cada etiqueta, y las URLs de esquema javascript: se eliminan de los atributos href/src, mientras que el formato normal, los enlaces reales, las imágenes, las tablas y los bloques de código quedan completamente intactos. Esto no es una opción que se pueda desactivar: el saneado siempre se ejecuta, tanto si vas a pegar la salida en una página en vivo hoy como si solo la guardas como archivo .html para abrirlo más tarde, porque un archivo guardado con una etiqueta <script> viva dentro es exactamente igual de peligroso en el momento en que se abre que lo sería el renderizado en línea.
Tu Markdown nunca sale de tu dispositivo
Tanto el análisis de Markdown a HTML como el paso de saneado son JavaScript puro del lado del cliente, ningún servidor ve jamás lo que pegas. Eso importa si lo que estás convirtiendo es documentación sin publicar, un manual interno, el README de un proyecto privado, o notas que preferirías no entregar a los registros de acceso de un servidor de terceros solo para obtener marcado HTML plano al otro lado. La conversión ocurre en el instante en que haces clic en el botón, usando el JavaScript ya cargado en tu pestaña.
Usos habituales
- Convertir un README o CHANGELOG de GitHub en HTML para una página de proyecto que no es en sí un sitio estático consciente de Markdown.
- Convertir notas de lanzamiento o documentación en Markdown en el cuerpo HTML de un email.
- Pegar notas con formato Markdown (de Notion, Obsidian, una exportación de chat) en un campo de CMS heredado que solo acepta HTML.
- Comprobar rápidamente cómo se renderizará realmente en HTML una tabla, una lista de tareas o un tachado antes de comprometerlo en un documento más grande.
- Producir HTML seguro y saneado a partir de Markdown que puede incluir contenido copiado y pegado de una fuente no fiable.
Si tu objetivo final es un PDF en lugar de HTML en bruto, el Convertidor de Markdown a PDF ejecuta este mismo pipeline de análisis/saneado y entrega el resultado directamente a un PDF paginado con estilo en un solo paso, en lugar de convertir a HTML aquí y luego a PDF por separado.
¿Estás construyendo el propio Markdown en lugar de convertir uno ya existente? El Generador de README reutiliza exactamente este mismo motor de renderizado para su propio panel de vista previa en vivo.
