Sintaxis Markdown: guía completa en español con ejemplos
Markdown es sencillo de aprender y difícil de olvidar: una vez que interiorizas los diez elementos básicos, puedes escribir documentos bien formateados en cualquier plataforma que lo soporte. Esta guía cubre toda la sintaxis que necesitas, desde los elementos más básicos hasta tablas y bloques de código con resaltado de sintaxis, con ejemplos que puedes probar directamente en WikiPlus Editor de Markdown sin necesidad de instalar nada.
Elementos básicos: títulos, párrafos y énfasis
Los títulos se crean añadiendo uno a seis símbolos # antes del texto. Un # es el título principal (H1, equivalente a <h1>), ## es un subtítulo (H2), ### es un sub-subtítulo (H3), y así hasta ######. Los párrafos son simplemente bloques de texto separados por una línea en blanco. Para negrita, rodea el texto con **doble asterisco** o __doble guión bajo__. Para cursiva, usa *un asterisco* o _un guión bajo_. Para negrita y cursiva combinadas, usa ***triple asterisco***. Para tachado (extensión GFM), usa ~~doble tilde~~. El texto sin marcado se convierte en párrafos normales. Una línea en blanco entre párrafos crea un nuevo párrafo HTML; no es necesario ningún marcado adicional para separar párrafos.
Listas, citas y líneas horizontales
Las listas con viñetas usan - o * al inicio de la línea (ambos son válidos y se pueden mezclar). Las listas numeradas usan 1. 2. 3. Los números reales no importan; Markdown los ordena automáticamente, así que puedes usar 1. en todas las líneas y el renderer los numera correctamente. Para anidar sublistas, añade cuatro espacios de sangría antes del elemento de la sublista. Las citas de bloque usan > al inicio de la línea; pueden anidarse con >> para citas dentro de citas. Las líneas horizontales se crean con tres o más guiones (---), asteriscos (***) o guiones bajos (___) en una línea propia. Se renderizan como la etiqueta HTML <hr>.
Código, tablas y enlaces
El código en línea se rodea con `backticks simples`. Los bloques de código usan tres backticks seguidos del nombre del lenguaje para activar el resaltado de sintaxis: ```python, ```javascript, ```bash. Las tablas requieren la extensión GFM: la primera fila es el encabezado separado por |, la segunda es la fila de separador con guiones (| --- |), y las siguientes son las filas de datos. Los enlaces en línea usan la sintaxis [texto visible](URL). Los enlaces con título tooltip usan [texto](URL "Título aquí"). Las imágenes son iguales que los enlaces pero con un ! al inicio: . Para referenciar URLs sin texto visible, rodéalas con <ángulos>: <https://ejemplo.com>.
Extensiones avanzadas: tareas, notas al pie y HTML inline
Las listas de tareas (GFM) usan - [ ] para pendiente y - [x] para completado. Son especialmente útiles en changelogs y archivos de progreso de proyectos. Las notas al pie (extensión en algunos dialectos) usan [^1] en el texto y [^1]: Texto de la nota al pie al final del documento. Markdown permite HTML inline directamente: puedes escribir <div>, <span>, <table> o cualquier otra etiqueta HTML dentro de un documento Markdown y se renderizará correctamente. Esto es útil para alineación de contenido o elementos de diseño que la sintaxis Markdown no cubre. La regla es que el HTML inline funciona correctamente en la mayoría de renderers excepto Typora en algunos modos.
Preguntas frecuentes
- ¿Cómo añado un salto de línea sin crear un párrafo nuevo en Markdown?
- Para crear un salto de línea sin nuevo párrafo (equivalente a <br>), añade dos espacios al final de la línea antes de pulsar Enter. Esto crea un salto de línea suave. En algunos renderers, también puedes usar el backslash \ al final de la línea. La mayoría de editores Markdown, incluido WikiPlus, soportan ambas formas.
- ¿Markdown soporta colores o estilos de fuente?
- No de forma nativa. Markdown estándar no tiene sintaxis para colores, tamaños de fuente ni familias tipográficas. Si necesitas texto de color, tienes que usar HTML inline directamente: <span style="color: red">texto rojo</span>. Algunos renderers como Notion o Confluence añaden extensiones propias para colores que no son portables entre plataformas.
- ¿Cuál es la diferencia entre Markdown, CommonMark y GFM?
- Markdown original (2004) es la especificación básica de John Gruber, con algunos ambigüedades en casos extremos. CommonMark es una especificación estándar de 2014 que resuelve esas ambigüedades y es implementada de forma consistente por muchos proyectos. GFM (GitHub Flavored Markdown) es un superconjunto de CommonMark que añade tablas, tareas, menciones y algunos elementos específicos de GitHub. WikiPlus Editor soporta CommonMark más las extensiones GFM más habituales.