Guía de Markdown: primeros pasos

Markdown es una sintaxis de formato en texto plano que transforma símbolos escritos en documentos estructurados, y lo esencial se aprende en unos 10 minutos. John Gruber lo lanzó en marzo de 2004 con la colaboración de Aaron Swartz, y 22 años después le da formato a los archivos README en GitHub, a las notas en Obsidian y a los posts en Reddit. Todo el sistema se compone de dos partes: un archivo de texto guardado con la extensión .md y un procesador que convierte ese texto a HTML. Todo lo que sigue se construye sobre esas dos partes.

¿Qué es Markdown?

Markdown es un lenguaje de marcado ligero creado en 2004 que agrega instrucciones de formato al texto plano por medio de caracteres visibles como #, * y >. Un # al inicio de una línea genera un encabezado. Dos asteriscos alrededor de una palabra la vuelven negrita. Un guion arranca una viñeta. El lanzamiento original fue un solo script de Perl, Markdown.pl, publicado en Daring Fireball, el sitio de Gruber.

Los lenguajes de marcado más pesados, entre ellos HTML y LaTeX, envuelven el contenido en etiquetas y comandos que saturan el archivo original. Markdown se fue por el camino opuesto. Gruber diseñó la sintaxis con una sola meta: que un archivo Markdown se lea limpio como texto plano antes de cualquier conversión. La línea ## Precios se ve como encabezado hasta para alguien que jamás ha escuchado de Markdown. Gracias a esa legibilidad, el formato pasó de los blogs en 2004 a GitHub en 2008, a Stack Overflow en 2010 y a apps de notas como Obsidian y Joplin durante la década de 2010.

En qué se diferencia Markdown de los editores WYSIWYG

Un editor WYSIWYG como Microsoft Word o Google Docs aplica el formato con botones de la barra de herramientas y esconde las instrucciones; Markdown deja cada instrucción a la vista como caracteres dentro del archivo. WYSIWYG significa "lo que ves es lo que obtienes". En Word seleccionas una frase y le das clic al botón de negritas, y el archivo guarda esa decisión en un XML binario que nunca llegas a ver. En Markdown escribes **fecha de lanzamiento** y los dos pares de asteriscos son el formato.

La diferencia aparece a la hora de guardar. Un archivo .docx abre bien en una lista corta de programas, principalmente Word, LibreOffice y Pages. Un archivo Markdown abre en cualquier editor de texto lanzado desde los años 70, desde el Bloc de notas hasta vim o VS Code. Muchos editores de Markdown resuelven la parte visual con una vista previa en pantalla dividida: la sintaxis cruda del lado izquierdo, el resultado renderizado del lado derecho, actualizado con cada tecla. Tienes la retroalimentación inmediata de Word con la transparencia del texto plano.

Por qué la gente usa Markdown

Quienes escriben eligen Markdown por cuatro razones prácticas: portabilidad, independencia de plataforma, durabilidad a futuro y alcance. Las cuatro vienen de su base de texto plano.

• Portabilidad. Un archivo Markdown se mueve entre aplicaciones sin conversión alguna. Escribe el borrador de un post en iA Writer, edítalo en VS Code y publícalo con Ghost. El archivo nunca cambia de forma. Los formatos propietarios como .docx y .pages encierran tu contenido en el ecosistema de un solo proveedor.
• Independencia de plataforma. Markdown funciona idéntico en Windows 11, macOS, Linux, iOS y Android. El archivo es texto UTF-8, así que una nota escrita en el celular en 2026 abre byte por byte idéntica en la computadora.
• Durabilidad a futuro. El software muere; los archivos de texto sobreviven. WordPerfect dominaba los procesadores de texto en 1990 y hoy recuperar sus archivos viejos es todo un proyecto. Un archivo Markdown de 2004 sigue abriendo en menos de un segundo, y eso importa para tesis, contratos y manuscritos de libros con horizontes de 20 años.
• Alcance. Plataformas como GitHub, GitLab, Reddit, Discord, Notion y Slack aceptan Markdown. Aprendes la sintaxis una vez y te funciona en todas.

Cómo funciona el procesamiento de Markdown

Markdown se vuelve un documento con formato a través de un proceso de 4 pasos: escribes un archivo .md, un procesador lo analiza, el procesador genera HTML y un navegador muestra ese HTML. El procesador, también conocido como parser o implementación, es el motor dentro de cada aplicación de Markdown. Entre los procesadores populares están markdown-it, marked, cmark y Pandoc, y cmark convierte un documento típico en menos de 10 milisegundos.

Cada herramienta muestra una parte distinta de este proceso. Un editor en línea con vista previa en vivo corre los pasos 2 al 4 de manera invisible con cada tecla. Un generador de sitios estáticos como Hugo corre el mismo proceso sobre cientos de archivos con un solo comando de compilación. El proceso en sí nunca cambia, y el HTML resultante se combina con cualquier hoja de estilos CSS o se convierte después a PDF, EPUB o .docx con una herramienta como Pandoc.

¿Para qué sirve Markdown?

Markdown resuelve siete tareas comunes: sitios web, notas, documentos, libros, presentaciones, correo electrónico y documentación técnica. La misma sintaxis de 10 minutos alcanza para las siete.

Sitios web

Los generadores de sitios estáticos como Hugo, Jekyll y Eleventy arman sitios web completos a partir de carpetas con archivos Markdown. Jekyll, lanzado en 2008, es el motor de GitHub Pages y su hosting gratuito. Las plataformas de contenido también aceptan Markdown: Ghost trae un editor Markdown nativo y WordPress lo admite mediante su editor de bloques. Un post de blog es un solo archivo .md, y los sistemas de control de versiones como Git registran cada edición que le hagas.

Notas y documentos

Apps de notas como Obsidian, Joplin, Bear y Simplenote guardan cada nota como Markdown. Tan solo Obsidian almacena cada bóveda como una carpeta de archivos .md en tu propio disco, así que una colección de 5,000 notas se mantiene localizable con herramientas estándar. Para documentos sueltos, cartas, minutas de juntas y tareas escolares, un editor de Markdown exporta directo a PDF o HTML, y ese PDF se imprime, se adjunta a un correo o se sube a donde quieras.

Libros y presentaciones

Leanpub convierte una carpeta de archivos Markdown en un ebook terminado en formatos PDF y EPUB, y Pandoc hace lo mismo desde la línea de comandos. Hay autores que han publicado novelas completas y libros técnicos de 300 páginas de esta manera. Para diapositivas, herramientas como Marp y Remark transforman un archivo Markdown en una presentación, con un separador --- por diapositiva, mucho más rápido de corregir que un PowerPoint con 40 diapositivas formateadas a mano.

Correo electrónico y documentación técnica

Extensiones de navegador como Markdown Here convierten Markdown en correo HTML con formato dentro de Gmail y otros clientes de correo web. La documentación es la cancha local de Markdown: GitHub renderiza un README.md en la parte superior de cada repositorio, y generadores como MkDocs, Docusaurus y Read the Docs arman sitios de documentación completos a partir de archivos .md. Docusaurus, lanzado por Meta en 2017, suma versionado y búsqueda encima de páginas Markdown normales.

Flavors de Markdown: CommonMark y GFM

Un flavor de Markdown es una variante específica de la sintaxis, y las dos que más importan son CommonMark, especificado en 2014, y GitHub Flavored Markdown, especificado en 2017. El lanzamiento de Gruber en 2004 dejó casos límite sin definir, como la sangría de las listas anidadas, así que los primeros procesadores no coincidían en el resultado. El mismo archivo se veía diferente según la herramienta.

CommonMark arregló eso. Publicada en septiembre de 2014 por un grupo de trabajo donde participaron John MacFarlane y Jeff Atwood, la especificación CommonMark amarra cada regla de análisis con más de 600 casos de prueba. Stack Overflow migró su renderizado a CommonMark en junio de 2020.

GitHub Flavored Markdown, o GFM, es un superconjunto estricto de CommonMark que GitHub formalizó en marzo de 2017. Agrega cinco extensiones: tablas, listas de tareas, tachado, autoenlaces y bloques de código delimitados con etiqueta de lenguaje. Cuando la página de un producto dice que "soporta Markdown", checa a qué flavor se refiere, porque una tabla GFM se ve como simples barras verticales en una herramienta que solo soporte CommonMark. GFM es la opción más segura en 2026, y es el flavor que renderiza el editor de este sitio.

Cómo empezar a usar Markdown hoy mismo

Abre un editor de Markdown en el navegador, escribe un # seguido de un título y listo, ya escribiste tu primer Markdown; no hay nada que instalar ni cuenta que crear. Un editor de doble panel te muestra el resultado renderizado mientras escribes, que es la forma más rápida de aprender la sintaxis con retroalimentación inmediata.

Comienza con los cinco elementos más usados: # para encabezados, **negritas**, *cursivas*, - para listas y [texto](url) para enlaces. Esos cinco cubren aproximadamente el 90% del formato del día a día. Practica reescribiendo algo real, una minuta de junta o una lista de pendientes, y guarda el resultado como archivo .md. De ahí en adelante, la guía de sintaxis básica cubre los 9 elementos centrales, y la guía de sintaxis extendida agrega tablas GFM, notas al pie y listas de tareas.

Preguntas frecuentes

¿Necesito instalar algún programa para escribir en Markdown?

Con un navegador web es suficiente; un editor de Markdown en línea cubre la escritura, la vista previa y la exportación sin instalar nada. Las aplicaciones de escritorio como Obsidian, iA Writer y VS Code agregan acceso sin conexión y manejo de archivos locales cuando las llegues a necesitar.

¿Qué extensión de archivo usa un archivo Markdown?

Los archivos Markdown usan la extensión .md, con .markdown como alternativa menos común. Las dos contienen texto plano idéntico, y todos los procesadores de Markdown, desde cmark hasta Pandoc, aceptan cualquiera de las dos.

¿Cuánto tiempo toma aprender Markdown?

Los cinco elementos básicos toman unos 10 minutos, y la sintaxis básica completa de 9 elementos se cubre en una sola sentada. Las extensiones de GFM, como tablas y listas de tareas, suman otros 15 minutos. Compara eso con LaTeX, donde formatear con soltura toma semanas.

¿Cuál es la diferencia entre CommonMark y GFM?

CommonMark es la especificación base de 2014 que estandariza el análisis del Markdown básico, y GFM es el superconjunto de GitHub de 2017 que agrega tablas, listas de tareas, tachado, autoenlaces y bloques de código delimitados. Todo documento CommonMark válido también es GFM válido, así que escribir en GFM es la opción práctica.