Conversor de Markdown a HTML

Cómo convertir Markdown a HTML online

Markdown nació de una idea sencilla: escribir debería sentirse como escribir, no como teclear etiquetas. En vez de envolver cada párrafo en <p>, cada título en <h2> y cada frase en negrita en <strong>, escribes unos pocos símbolos de texto plano que ya se parecen al formato que representan, y un parser convierte eso en marcado real por debajo. Esta herramienta es ese parser, funcionando por completo en tu navegador, lista para cuando necesites entregar HTML limpio a un sitio web, un CMS, una plantilla de correo o una página estática.

La gente recurre a un conversor como este todo el tiempo sin necesariamente llamarlo "convertir Markdown". Un desarrollador copia el README de un repositorio y lo necesita como fragmento de HTML para un sitio de documentación. Una redactora técnica escribe un artículo de ayuda en Markdown porque es más rápido de teclear, y luego tiene que pegar el HTML terminado en una plataforma de soporte que no entiende Markdown en absoluto. Alguien de marketing redacta el esquema de un boletín en un editor de texto plano y necesita HTML válido para el editor de campañas. En todos estos casos la tarea de fondo es la misma: tomar sintaxis Markdown y convertirla en marcado que un navegador o un CMS puedan renderizar correctamente, sin introducir errores, etiquetas rotas ni espacios sobrantes por el camino.

Guía paso a paso para convertir

1. Pega tu Markdown. Coloca tu texto en el editor "Markdown de entrada" de la izquierda. Puedes pegarlo desde un editor de código, una app de notas, un archivo README, o escribirlo directamente aquí.
2. Haz clic en "Convertir a HTML". El parser recorre tu texto línea por línea, reconoce títulos, listas, bloques de código, tablas, enlaces, imágenes y formato en línea, y arma el HTML correspondiente en bastante menos de un segundo.
3. Revisa la Vista previa en vivo. El resultado renderizado aparece de inmediato debajo, con un estilo parecido al que tendría en una página web normal, así detectas una línea en blanco que falta o un asterisco suelto antes de enviar ese marcado a cualquier lado.
4. Copia o descarga el resultado. Toma el HTML crudo desde el cuadro "HTML de salida" con un clic en Copiar, o usa "Descargar .html" para guardarlo como archivo independiente que puedas abrir, adjuntar o entregarle a un compañero de equipo.

Nada de esto toca un servidor. En el momento en que haces clic en Convertir, el JavaScript que corre en tu propio dispositivo hace todo el análisis, lo que significa que la herramienta funciona igual sea que tu documento tenga tres líneas o tres mil, y que nada de lo que pegues se envía a ningún lado para su procesamiento.

Markdown frente a HTML: guía de sintaxis

Si ya conoces algo de HTML, Markdown te va a parecer menos un lenguaje nuevo y más una forma abreviada de escribirlo. La siguiente tabla compara la sintaxis Markdown más habitual con el HTML que genera, para que veas exactamente qué está haciendo este conversor por dentro.

Hay un par de detalles fáciles de pasar por alto. La negrita y la cursiva usan el mismo símbolo, el asterisco, así que **texto** y *texto* solo se diferencian por cuántos escribes, y mezclarlos sin cerrar los pares produce un marcado desalineado. Las tablas necesitan una fila de encabezado, una fila separadora hecha de guiones y barras verticales, y luego las filas de datos, en ese orden exacto, o el parser tratará todo el bloque como párrafos normales en lugar de como una tabla.

Por qué este conversor funciona por completo en tu navegador

La mayoría de las herramientas para "convertir Markdown a HTML" que encuentras en internet suben en silencio lo que pegas a un servidor, lo procesan ahí con un parser, y te devuelven el resultado. Ese viaje de ida y vuelta es invisible para la mayoría de los usuarios, pero significa que tu texto, aunque sea por un instante, estuvo en la máquina de otra persona. Para un README público eso no importa nada. Para una página de wiki interna, una propuesta para un cliente, la especificación de un producto sin lanzar, o cualquier cosa cubierta por un acuerdo de confidencialidad, sí es un problema real.

Este conversor nunca hace ese viaje. La función que analiza el Markdown es JavaScript plano que viaja con la página y se ejecuta en tu dispositivo en el instante en que haces clic en Convertir. Abre la pestaña de red de tu navegador mientras lo usas y no verás ni una sola petición que lleve tu Markdown a ningún sitio. Eso trae dos efectos prácticos además de la privacidad: no hay cola de servidor que esperar, así que la conversión es prácticamente instantánea incluso con una conexión lenta, y no hay límite de peticiones por minuto ni tope de tamaño de archivo impuesto por un backend, porque es tu propia computadora la que hace todo el trabajo.

Lo que esto significa para los equipos

Si estás pegando documentación interna, datos de clientes, cláusulas de un contrato o cualquier otra cosa que no querrías que saliera de tu organización, una herramienta puramente del lado del cliente elimina ese riesgo de la ecuación en vez de pedirte que confíes en una política de privacidad. Es la misma razón por la que a los desarrolladores les gusta correr un formateador o un linter en local en vez de pegar código fuente propietario en un formulario web cualquiera.

Compatibilidad con GitHub Flavored Markdown

GitHub Flavored Markdown, casi siempre abreviado como GFM, es el dialecto que la mayoría de los desarrolladores escribe en el día a día, porque es el que se renderiza en GitHub, GitLab y la mayoría de los foros técnicos. Extiende la especificación original de Markdown con un puñado de funciones que los documentos de texto plano llevaban tiempo necesitando: tablas construidas con barras verticales, texto tachado, y bloques de código delimitados que pueden llevar una etiqueta de lenguaje para el resaltado de sintaxis.

• Bloques de código con etiqueta de lenguaje: envuelve el código entre triple comilla invertida y agrega el nombre del lenguaje justo después de la apertura, como ```python, y el conversor genera una etiqueta <code class="language-python"> que un resaltador de sintaxis como Prism o highlight.js puede reconocer automáticamente en cuanto el HTML llega a tu página.
• Tablas con barras verticales: arma una tabla con barras verticales y una fila separadora de guiones, y se convierte en una <table> completa con <thead> y <tbody>, lista para heredar el estilo de tabla que ya tenga tu sitio.
• Texto tachado: envuelve el texto entre doble virgulilla para marcarlo como tachado, útil para entradas de un registro de cambios, notas sobre una API obsoleta o tareas pendientes que ya quedaron completadas.
• HTML crudo sin tocar: si dejas caer etiquetas HTML de verdad dentro de tu Markdown, como un <span> con una clase específica o un <br> para forzar un salto de línea manual, el conversor las deja exactamente como están en vez de escaparlas, tal como lo indica la especificación original de Markdown.

Este parser es deliberadamente ligero, no una reimplementación línea por línea de la especificación CommonMark completa. Maneja muy bien la sintaxis que aparece en documentos reales: archivos README, registros de cambios, borradores de blog, documentación interna. Lo que no intenta cubrir es el anidamiento extremo, como una lista numerada dentro de una cita dentro de la celda de una tabla. Si tu documento se apoya en títulos, listas, bloques de código, tablas, enlaces, imágenes y formato en línea, que cubre la inmensa mayoría de la escritura técnica y editorial, el resultado sale limpio siempre.

Este conversor frente a Pandoc, marked.js y otras opciones

Si buscas "convertir Markdown a HTML" te vas a topar con un puñado de herramientas muy distintas entre sí, y conviene saber cuándo encaja cada una.

• Herramientas de línea de comandos como Pandoc. Pandoc es el peso pesado del mundo Markdown, capaz de convertir entre decenas de formatos de documento con soporte completo de CommonMark, notas al pie, citas bibliográficas y plantillas personalizadas. Es la opción correcta para una canalización de compilación o el manuscrito de un libro, pero implica instalar un binario, aprender sus opciones de línea de comandos y ejecutarlo desde una terminal, demasiado esfuerzo para convertir una sola entrada de un registro de cambios o el borrador de un correo.
• Librerías de JavaScript como marked.js o showdown. Son las que usan por debajo muchas aplicaciones web, incluido el parser que impulsa esta misma página. Son excelentes cuando estás construyendo el renderizado de Markdown dentro de tu propio producto, pero necesitan npm, un empaquetador y unas cuantas líneas de código de integración antes de hacer nada, más configuración de la que casi nadie quiere para una conversión puntual.
• Extensiones de navegador y aplicaciones de escritorio. Prácticas si conviertes Markdown todo el tiempo y quieres tenerlo integrado en tu sistema operativo, pero requieren instalar algo y confiarle acceso al portapapeles, más compromiso que simplemente pegar texto en una página.
• Una herramienta en el navegador como esta. Sin instalación, sin terminal, sin cuenta. Pegas, haces clic en Convertir, y el HTML está listo. Es la herramienta indicada para el noventa por ciento de los casos en los que necesitas una conversión limpia ahora mismo y no quieres sumar una dependencia a un proyecto solo para resolver esto.

Ninguno de estos enfoques es "mejor" en términos absolutos. Un flujo de publicación grande de verdad necesita la profundidad de Pandoc, y un sitio web en producción de verdad necesita una librería empaquetada que pueda invocar en cada carga de página. Esta herramienta existe para el momento, mucho más frecuente, que queda en el medio: tienes algo de Markdown, necesitas HTML, y lo necesitas en los próximos diez segundos, no después de instalar nada.

Usos habituales de este conversor de Markdown a HTML

La misma herramienta termina en escritorios muy distintos según quién la use. Hay algunos patrones que se repiten una y otra vez.

Migración de generadores de sitios estáticos a un CMS tradicional

Los equipos que escriben en Jekyll, Hugo o Eleventy a veces necesitan reproducir una entrada o página concreta dentro de un CMS tradicional como WordPress, que espera HTML en vez de front-matter y archivos Markdown. En lugar de escribir a mano las etiquetas de un artículo de cinco mil palabras, pegar el Markdown de origen aquí y tomar el HTML de salida ahorra por completo la conversión manual.

Archivos README y documentación para desarrolladores

Quienes mantienen proyectos de código abierto suelen necesitar el mismo contenido de un README en dos lugares: renderizado automáticamente en GitHub, e incrustado como HTML estático en el sitio de documentación o la página de aterrizaje propia del proyecto. Convertirlo una vez aquí mantiene ambas versiones consistentes sin tener que mantener dos copias separadas del mismo contenido.

Artículos de soporte y bases de conocimiento

Muchas plataformas de mesa de ayuda y bases de conocimiento aceptan texto enriquecido o HTML, pero no Markdown de forma directa. Los redactores técnicos que escriben más rápido en Markdown, porque no tienen que pelear con una barra de herramientas de formato, usan este conversor como último paso antes de pegar el artículo terminado en el editor de la plataforma de soporte.

Boletines y plantillas de correo

Las herramientas de correo casi siempre necesitan HTML, pero escribir el borrador de un boletín en Markdown es mucho más rápido que pelear con un editor de arrastrar y soltar solo para lograr una estructura básica. Convertir el borrador aquí produce marcado limpio de párrafos, listas y enlaces que encaja en la vista HTML de la mayoría de las plataformas de email.

Apuntes, material de clase y contenido de cursos

Estudiantes y docentes que toman apuntes en Markdown, en una app como Obsidian o en un simple editor de texto, recurren a este conversor cuando un conjunto concreto de notas tiene que convertirse en una página web para compartir, o pegarse en un sistema de gestión de aprendizaje que no entiende la sintaxis Markdown.

Consejos para una salida limpia y errores comunes

Un poco de disciplina con la sintaxis Markdown recorre un largo trecho hacia obtener exactamente el HTML que esperas al primer intento.

• Deja una línea en blanco entre bloques. Un título, un párrafo, una lista o una tabla necesitan una línea vacía arriba y abajo. Si escribes dos párrafos seguidos sin una línea en blanco entre ellos, se fusionan en un solo bloque en vez de quedar como dos independientes.
• Arma la estructura de la tabla con exactitud. La fila de encabezado, la fila separadora de guiones y cada fila de datos deben ir cada una en su propia línea, usando barras verticales para separar columnas. Si te saltas la fila separadora, todo el bloque se convierte en texto de párrafo normal.
• Haz coincidir tus marcadores de énfasis. Cada ** o * de apertura necesita su pareja de cierre en la misma línea. Un asterisco sin su pareja en cualquier parte de un párrafo descoloca todo lo que viene después.
• Cierra siempre el bloque de código. Un bloque que abre con triple comilla invertida pero nunca se cierra se traga el resto del documento dentro de una única etiqueta <pre>, así que revisa siempre el cierre cuando un bloque salga más largo de lo esperado.
• Usa la Vista previa en vivo antes de copiar. Es la forma más rápida de detectar un título que no se renderizó, una lista que se fusionó en un párrafo, o una tabla que salió como texto plano, antes de que ese HTML llegue a algún lugar importante.

Si alguna vez el resultado se ve distinto a lo que esperabas, casi siempre la causa es una línea en blanco que falta o un bloque de código sin cerrar, no un error en la sintaxis en sí. El minimalismo de Markdown es también su rigor: cuanta menos puntuación usa, más precisa tiene que ser la posición de esa puntuación.

Preguntas frecuentes

Herramientas de contenido relacionadas

🔒 Privacidad 100% en tu Navegador

Todo el análisis de Markdown ocurre <strong>completamente en tu navegador</strong>. Ningún contenido se sube a ningún servidor. Tu Markdown permanece en tu dispositivo.