Markdown es un lenguaje de marcado ligero que permite dar formato a un texto —títulos, listas, enlaces, énfasis— con caracteres normales, manteniéndose fácil de leer en su forma sin procesar, a diferencia de HTML, que es difícil de leer sin renderizarlo.
Sintaxis básica
# Título— títulos de distintos niveles según la cantidad de caracteres#.**negrita**y*cursiva*— énfasis de texto.[texto](url)— un enlace.- elementoo1. elemento— listas con viñetas y numeradas.- ``` — bloques de código con resaltado de sintaxis según el nombre del lenguaje.
Por qué un mismo título puede generar dos anclas distintas
Cuando un editor convierte un encabezado en un enlace interno, genera un "slug" a partir del texto: minúsculas, espacios cambiados por guiones. Muchos generadores además eliminan los signos diacríticos, así que un título como ## Configuración puede producir el ancla #configuracion (sin tilde) en un motor y #configuración en otro. Si se enlaza manualmente a un encabezado con eñes o tildes, conviene comprobar qué ancla generó realmente el renderizador de destino, porque no hay una regla universal.
El Markdown original no definía tablas ni CommonMark existía
El Markdown que John Gruber publicó en 2004 era una descripción en prosa, no una gramática formal, y no incluía tablas, texto tachado ni bloques de código con lenguaje resaltado. Durante una década cada implementación resolvió a su manera los casos que el texto original dejaba ambiguos, hasta que en 2014 surgió CommonMark para fijar una gramática precisa, y GitHub Flavored Markdown (GFM) añadió sobre esa base las tablas y listas de tareas que hoy se dan por sentadas en cualquier README.
Convertir a HTML y de vuelta
La conversión Markdown → HTML es directa: un analizador reconoce las construcciones sintácticas y genera las etiquetas correspondientes. La conversión inversa, HTML → Markdown, es más complicada, ya que HTML admite muchas más opciones de formato que el Markdown básico, así que parte del marcado (tablas complejas, estilos anidados) puede simplificarse o perderse.
Para qué sirve
- Previsualizar rápidamente cómo se verá un archivo Markdown renderizado, sin publicarlo.
- Convertir el contenido de una página o documento a Markdown para guardarlo en un sistema de control de versiones.
- Preparar contenido HTML para insertarlo en una aplicación que solo acepta Markdown.