Markdown a HTML

Qué es Markdown y por qué se volvió universal

Markdown lo creó John Gruber en 2004 con una idea simple: que un texto plano pueda ser leído tal cual y, al mismo tiempo, convertirse a HTML estructurado. Veinte años después es el formato dominante en READMEs de GitHub, en Notion, en Slack, en Discord, en la mayoría de generadores de sitios estáticos. Si escribís contenido técnico, ya conocés sus reglas.

Sintaxis básica que cubre este conversor

• Títulos: # H1, ## H2, hasta ###### H6.
• Énfasis: **negrita**, *cursiva*, ~~tachado~~.
• Listas: - item o 1. item para ordenadas.
• Links: [texto](url).
• Imágenes: ![alt](url).
• Código: `inline` o triple backtick para bloques.
• Citas: > cita.
• Líneas horizontales: tres guiones (---).

Por qué convertir en el navegador

La mayoría de conversores online suben tu texto a un servidor. Para un README público no importa, pero si estás procesando un draft confidencial, notas internas o un documento legal, no querés que tu contenido pase por máquinas que no controlás. Este conversor corre 100% en JavaScript local: tu texto nunca sale del navegador.

Cuándo usar Markdown y cuándo no

Markdown brilla cuando el contenido es lineal: blog posts, documentación, mensajes en chat, READMEs, issues. Se queda corto cuando necesitás layouts complejos (multi columnas, posicionamiento absoluto, animaciones) o atributos específicos de HTML (data-attributes, aria-labels). Para esos casos, escribir HTML directo o usar MDX (Markdown + JSX) es mejor.

Variantes que existen

• CommonMark: el intento de estandarizar el Markdown original. Define ambigüedades del spec de Gruber.
• GitHub Flavored Markdown (GFM): agrega tablas, listas de tareas, autolinks, mención de usuarios.
• MDX: permite incluir componentes JSX dentro de Markdown. Lo usan Docusaurus, Astro, Next.
• Obsidian / Notion: sus propios dialectos con backlinks, embeds y bases de datos.

Tips de productividad

• Aprendé los 5 atajos más comunes (#, **, -, [], `) y vas a escribir más rápido en cualquier herramienta moderna.
• Usá un editor con preview en vivo (Typora, Obsidian, VS Code con la extensión Markdown Preview Enhanced).
• Para tablas, usá un generador específico — escribirlas a mano en Markdown es tedioso.
• Si vas a publicar el HTML en un sitio, sanitizá la salida si el contenido viene de usuarios externos.