¿Qué es Markdown? Guía completa de sintaxis y formato Markdown

¿Qué es Markdown?

Markdown es un lenguaje de marcado ligero creado por John Gruber en 2004. Su objetivo es permitir que las personas escriban contenido en un formato de texto plano fácil de leer y escribir, que al mismo tiempo pueda convertirse a HTML válido. Los archivos Markdown usan la extensión .md y son compatibles con prácticamente todas las plataformas de desarrollo, sistemas de gestión de contenido y aplicaciones de notas.

La filosofía clave de Markdown es que un documento debe ser legible incluso en su forma cruda, sin necesidad de renderizado especial. Esto lo hace ideal para control de versiones, edición colaborativa y documentación técnica.

Encabezados

Markdown soporta seis niveles de encabezados, creados anteponiendo de uno a seis símbolos de almohadilla:

• # Encabezado 1 — El encabezado más grande, usado típicamente para títulos de página
• ## Encabezado 2 — Encabezados de secciones principales
• ### Encabezado 3 — Encabezados de subsecciones
• #### Encabezado 4 a ###### Encabezado 6 — Encabezados progresivamente más pequeños

Formato de texto

Markdown proporciona sintaxis simple para formato básico de texto:

• Texto en negrita: Envuelve el texto en asteriscos dobles (**negrita**) o guiones bajos dobles (__negrita__)
• Texto en cursiva: Envuelve el texto en asteriscos simples (*cursiva*) o guiones bajos simples (_cursiva_)
• Texto tachado: Envuelve el texto en tildes dobles (~~tachado~~)
• Código en línea: Envuelve el texto en acentos graves (`código`)

Listas

Markdown soporta listas ordenadas y desordenadas:

• Listas desordenadas: Usa asteriscos (*), signos más (+) o guiones (-) como marcadores
• Listas ordenadas: Usa números seguidos de puntos (1., 2., 3.)
• Listas anidadas: Indenta elementos con dos o cuatro espacios para crear sublistas

Enlaces e imágenes

Agregar enlaces e imágenes es sencillo:

• Enlaces: [Texto del enlace](URL) crea un hipervínculo
• Imágenes: ![Texto alternativo](url-imagen) inserta una imagen
• Enlaces por referencia: Define enlaces al final del documento para mayor legibilidad

Bloques de código

Para código de múltiples líneas, usa triples acentos graves (```) o triples tildes (~~~). Puedes especificar el lenguaje de programación después del marcador de apertura para resaltado de sintaxis.

Tablas

Las tablas Markdown usan pipes y guiones para crear filas y encabezados. Las tablas básicas son parte del Markdown estándar, mientras que las funciones extendidas como la alineación de celdas usan la especificación GitHub Flavored Markdown (GFM).

Citas en bloque y líneas horizontales

Las citas en bloque se crean con el símbolo > y son útiles para citar fuentes. Las líneas horizontales se pueden crear con tres o más guiones (---), asteriscos (***) o guiones bajos (___).

La simplicidad y universalidad de Markdown lo convierten en el formato preferido para desarrolladores, escritores y cualquiera que necesite crear contenido de texto bien estructurado rápidamente.