Sintaxis avanzada de Markdown

Funcionalidades avanzadas de Markdown. Fórmulas matemáticas con KaTeX y MathJax, diagramas Mermaid, front matter YAML y componentes MDX.

Markdown ofrece funcionalidades avanzadas que van más allá de la sintaxis básica y la sintaxis extendida. Estas características permiten crear contenido más rico y complejo: fórmulas matemáticas, diagramas generados desde texto, metadatos para generadores de sitios estáticos y componentes interactivos de React.

No todas las plataformas soportan estas funcionalidades. Cada guía indica dónde funciona y qué configuración necesitas.

Guías de sintaxis avanzada

Matemáticas con Markdown (KaTeX y MathJax)

Aprende a escribir fórmulas matemáticas en Markdown usando la sintaxis LaTeX. Cubre desde expresiones simples (fracciones, exponentes, raíces) hasta matrices, integrales, sumatorios y ecuaciones alineadas. Funciona en GitHub, GitLab, Obsidian, Jupyter Notebooks y cualquier plataforma que soporte KaTeX o MathJax. Una herramienta imprescindible para estudiantes de ciencias, ingeniería y matemáticas.

Diagramas con Mermaid en Markdown

Crea diagramas de flujo, secuencia, Gantt, clases, estado, entidad-relación, mapas mentales, timelines y más, directamente desde texto. Mermaid interpreta tu código y genera el gráfico visual automáticamente. Funciona de forma nativa en GitHub, GitLab, Obsidian y Notion. Guía completa con 12 tipos de diagrama, tablas de referencia de sintaxis, personalización con temas y ejemplos prácticos.

Front matter en Markdown (YAML y TOML)

El front matter es un bloque de metadatos al inicio de un archivo Markdown que define propiedades como título, fecha, autor, etiquetas y descripción. Es esencial para generadores de sitios estáticos como Hugo, Jekyll, Astro o Eleventy, que usan estos metadatos para organizar y renderizar el contenido. Aprende la sintaxis YAML y TOML, los campos más comunes y cómo usarlo en tu blog o documentación.

MDX: Markdown con componentes JSX

MDX combina Markdown con JSX, permitiéndote usar componentes de React directamente dentro de tus documentos Markdown. Esto abre la puerta a contenido interactivo: gráficos dinámicos, formularios, demos en vivo, tabs y cualquier componente que puedas construir con React. Es el formato que usan frameworks como Next.js, Docusaurus, Astro y Gatsby para crear documentación y blogs con funcionalidades avanzadas. Esta misma web está construida con MDX.

¿Por dónde empezar?

Si trabajas con documentación técnica o código, empieza por Mermaid: los diagramas son la funcionalidad avanzada más universal y la que más impacto visual tiene. Si eres estudiante o investigador, ve directo a Matemáticas. Si estás montando un blog o un sitio web, front matter y MDX son los que necesitas.

👋 Hola! Soy Edu, me encanta crear cosas y he redactado este tutorial. Si te ha resultado útil, el mayor favor que me podrías hacer es el de compatirlo en Twitter.

para estar al día con mi contenido. 😊