Markdown to HTML
Convierte texto Markdown a HTML al instante.
¿Qué es Markdown y por qué es el estándar de la documentación?
Markdown es un lenguaje de marcado ligero creado por John Gruber en 2004 con el objetivo de permitir escribir texto formateado usando una sintaxis simple y legible que pueda convertirse fácilmente a HTML válido. Su filosofía central es que un documento Markdown debe ser legible tal cual, sin que las etiquetas de formato distraigan de la lectura.
Hoy en día, Markdown es el formato estándar para documentación técnica (README.md en GitHub), blogs estáticos (Jekyll, Hugo, Astro), notas personales (Obsidian, Notion), mensajería (Slack, Discord) y plataformas de preguntas y respuestas (Stack Overflow). Dominar Markdown es esencial para cualquier desarrollador moderno.
Casos de uso prácticos
README de proyectos: Todo repositorio de Git necesita un README.md bien formateado con instrucciones de instalación, uso y contribución. Es la primera impresión de tu proyecto para otros desarrolladores.
Blogs técnicos: Generadores de sitios estáticos como Hugo, Jekyll, Astro y Next.js usan Markdown como formato principal para escribir artículos, permitiendo enfocarte en el contenido sin distracciones de editores WYSIWYG.
Documentación de APIs: Herramientas como Docusaurus y MkDocs generan sitios de documentación completos a partir de archivos Markdown, con navegación, búsqueda y versionado.
Preguntas frecuentes
¿Puedo usar HTML dentro de Markdown?
Sí, la mayoría de procesadores Markdown permiten HTML embebido. Puedes usar etiquetas como <details>, <table>, <img> o <div> directamente. Sin embargo, algunos procesadores (como GitHub) sanitizan el HTML por seguridad, eliminando scripts y estilos.
¿Qué es GFM (GitHub Flavored Markdown)?
GFM es la variante de Markdown que usa GitHub, que añade funcionalidades como tablas, listas de tareas (checkboxes), tachado de texto (~~texto~~), autolinks y resaltado de sintaxis en bloques de código con triple backtick.
¿Cómo añado imágenes en Markdown?
La sintaxis es . Puedes usar URLs absolutas o rutas relativas. Para mayor control del tamaño, usa HTML: <img src="url" width="400" alt="descripción">.
¿Markdown soporta notas al pie?
No en el estándar original, pero extensiones como Markdown Extended y GFM soportan footnotes con la sintaxis [^1] para la referencia y [^1]: texto de la nota al pie para la definición.
Sintaxis Markdown esencial
| Elemento | Sintaxis | Resultado |
|---|---|---|
| Negrita | **texto** | texto |
| Cursiva | *texto* | texto |
| Enlace | [texto](url) | enlace clicable |
| Código | `código` | código inline |
| Lista | - elemento | lista con viñetas |