Markdown: el formato de texto ligero
Historia y evolución
Markdown fue creado en 2004 por John Gruber con la colaboración del activista Aaron Swartz. El objetivo era crear un formato de texto plano que pudiera convertirse a HTML válido sin la complejidad del marcado manual.
El punto de inflexión llegó cuando GitHub adoptó Markdown para los archivos README en 2008, convirtiéndolo en el estándar de facto de la documentación de proyectos de software. Stack Overflow, Reddit y muchas otras plataformas lo integraron poco después.
La falta de especificación formal generó un proliferación de dialectos incompatibles. Intentos de estandarización como CommonMark (2014) han logrado cierta armonización. Hoy, Markdown es el formato por defecto en GitHub, GitLab, Notion, Obsidian y miles de herramientas de documentación.
Buenas prácticas
Conocer las variantes del dialecto que se usa. GitHub Flavored Markdown soporta tablas, listas de tareas y resaltado de sintaxis; el Markdown original no. Revisar la documentación de la plataforma evita problemas de renderizado.
Estructura jerárquica consistente. Usar un solo H1 por documento y jerarquizar correctamente los niveles de encabezado mejora la accesibilidad y la estructura semántica del documento resultante.
Espacios en blanco significativos. Markdown es sensible a los saltos de línea: un salto simple a veces no crea un párrafo nuevo. Separar párrafos con una línea en blanco evita errores inesperados de renderizado.
Evitar HTML inline. Markdown permite mezclar HTML, pero abusar de él elimina la principal ventaja del formato: la legibilidad en texto plano. Reservarlo para casos donde Markdown no ofrece alternativa nativa.
Casos de uso
Markdown es el formato de referencia para la documentación técnica: archivos README, wikis de proyectos, guías de instalación y referencias de API, porque permite un control de versiones eficiente con Git. En blogs y plataformas de contenido (Ghost, Jekyll, Hugo), permite a los redactores escribir sin depender de editores WYSIWYG complejos. En entornos de ciencia de datos, los Jupyter Notebooks combinan código Python con texto en Markdown para crear documentos analíticos reproducibles.
Curiosidades
- Aaron Swartz, coautor de Markdown, fue también cofundador de Reddit, creador del formato de sindicación RSS y defensor de los derechos digitales. Murió en 2013 a los 26 años.
- El nombre "Markdown" es un juego de palabras: en tipografía, "markup" (marcado) añade información al texto. Markdown es lo contrario: texto plano que simplifica la notación.
- Obsidian, una de las aplicaciones de toma de notas más populares entre profesionales del conocimiento, usa archivos Markdown puros legibles sin ningún programa especial.
- La especificación CommonMark de Markdown tiene más de 600 ejemplos de casos límite documentados. A pesar de su aparente simplicidad, la definición formal precisa del formato es sorprendentemente compleja.