Markdown es un lenguaje de marcado ligero que te permite formatear texto usando convenciones de texto plano que se ven naturales cuando los lees. Un encabezado es # Encabezado. El texto en negrita es **negrita**. Un elemento de lista comienza con un guion. Creado por John Gruber en 2004, Markdown es ahora el formato de escritura estándar para archivos README de GitHub, documentación técnica, plataformas de blog y herramientas de comunicación para desarrolladores. Aprenderlo toma menos de una hora y elimina la fricción de formato que ralentiza la escritura técnica.
Sintaxis de Formato Básica
Los encabezados usan el símbolo de almohadilla: # para H1, ## para H2, ### para H3, hasta ###### para H6. El número de almohadillas corresponde al nivel de encabezado HTML. Siempre pon un espacio entre la almohadilla y el texto. La mayoría de los renderizadores también admiten encabezados estilo setext usando subrayado con === o ---, pero el estilo de almohadilla es más portátil y compatible universalmente.
El énfasis usa asteriscos o guiones bajos: *cursiva* o _cursiva_ produce cursiva, y **negrita** o __negrita__ produce negrita. Combinarlos da ***negrita cursiva***. Para código en línea, envuelve el texto en comillas invertidas: `código`. Para texto tachado (compatible con GitHub Flavored Markdown), usa ~~texto~~.
Los enlaces usan una sintaxis de dos partes: [texto del enlace](https://url.com). Las imágenes son iguales con un prefijo de signo de exclamación: . Los enlaces de estilo referencia te permiten definir URLs por separado: [texto del enlace][ref] en el punto de uso y [ref]: https://url.com al final del documento.
Listas, Citas y Reglas Horizontales
Las listas desordenadas usan guiones, asteriscos o signos más seguidos de un espacio: - elemento, * elemento o + elemento. Las listas ordenadas usan números seguidos de un punto: 1. elemento. Los números reales que uses no importan — Markdown los renumera automáticamente. Las listas anidadas se crean indentando con dos o cuatro espacios.
Las citas usan el carácter >: > Esto es una cita. Las citas multilínea pueden comenzar cada línea con > o solo la primera, dependiendo del renderizador. Las citas anidadas usan >>. Las citas se renderizan con estilo de borde izquierdo en la mayoría de los renderizadores de Markdown.
Las reglas horizontales se crean con tres o más guiones, asteriscos o guiones bajos en su propia línea: ---, *** o ___. Los párrafos en Markdown están separados por líneas en blanco — un solo salto de línea no crea un nuevo párrafo. Esta es una de las fuentes más comunes de confusión para los nuevos escritores de Markdown.
Bloques de Código y Tablas
Los bloques de código cercado usan triple comilla invertida antes y después del código. Agregar un identificador de lenguaje después de las comillas de apertura habilita el resaltado de sintaxis: ```javascript. La mayoría de los renderizadores de Markdown admiten resaltado de sintaxis para docenas de lenguajes. Los bloques de código indentados (cuatro espacios de indentación) también funcionan pero son menos legibles.
Las tablas son una extensión de GitHub Flavored Markdown (GFM). Las columnas están separadas por caracteres de barra vertical, y la fila de encabezado está separada del cuerpo por una fila de guiones. La alineación de columnas se controla con dos puntos en la fila separadora: :--- para izquierda, ---: para derecha, :---: para centro.
Escapar caracteres especiales usa una barra diagonal inversa: \* para mostrar un asterisco literal, \# para mostrar una almohadilla literal. Los caracteres que necesitan escaparse son: \, `, *, _, {}, [], (), #, +, -, ., y !. Si tu texto formateado se está renderizando de manera inesperada, verifica si hay activadores no intencionados de Markdown en tu fuente.
Convertir Markdown a HTML
Markdown es un formato fuente — necesita convertirse a HTML para mostrarse en un navegador. Cada lenguaje de programación principal tiene una biblioteca de análisis de Markdown: marked y markdown-it en JavaScript, python-markdown en Python, kramdown en Ruby. Los generadores de sitios estáticos como Jekyll, Hugo y Eleventy convierten Markdown a HTML en tiempo de compilación.
Al convertir Markdown a HTML para contenido generado por usuarios, siempre sanea la salida para prevenir la inyección XSS. Un usuario que envíe Markdown con una etiqueta HTML en línea <script> podría ejecutar JavaScript arbitrario si el HTML se renderiza sin saneamiento. Bibliotecas como DOMPurify (navegador) y sanitize-html (Node.js) eliminan etiquetas peligrosas preservando el formato seguro.
Los sabores extendidos de Markdown agregan características más allá de la especificación original. GitHub Flavored Markdown (GFM) agrega tablas, listas de tareas (- [x] hecho) y vinculación automática de URL. CommonMark es una especificación estandarizada que resuelve ambigüedades en la especificación original de Gruber.
Markdown reduce la carga cognitiva de escribir documentos formateados manteniendo la fuente legible sin un editor especial. Una vez que la sintaxis se convierte en memoria muscular, escribes más rápido porque nunca abandonas el teclado para hacer clic en botones de formato. Un convertidor de Markdown a HTML es invaluable para probar cómo se renderizará tu contenido, depurar problemas de formato y generar HTML limpio para copiar y pegar en sistemas de gestión de contenido que aceptan entrada HTML.