El Markdown básico no tiene sintaxis para fórmulas, pero casi todas las herramientas modernas de Markdown admiten fórmulas LaTeX mediante una extensión. Escribes la fórmula en notación TeX entre signos de dólar, y un motor de renderizado matemático como KaTeX o MathJax la convierte en matemáticas bien compuestas.
Esta guía cubre la sintaxis que funciona en GitHub, GitLab, Obsidian, Jupyter y Markdown Preview Editor, y te ofrece una referencia de los comandos que más vas a usar.
Fórmulas en línea y destacadas
En Markdown hay dos tipos de fórmulas:
- Las fórmulas en línea van dentro de una frase. Rodéalas con un signo de dólar:
$E = mc^2$. - Las fórmulas destacadas ocupan su propia línea centrada. Rodéalas con dos signos de dólar, normalmente en líneas separadas.
markdownLa famosa fórmula $E = mc^2$ cabe dentro de una frase.
$$
x = \frac{-b \pm \sqrt{b^2 - 4ac}}{2a}
$$
Renderizada, la fórmula destacada queda así:
Sintaxis esencial
| Qué | Escribes | Notas |
|---|---|---|
| Superíndice | x^2, e^{i\pi} |
Usa llaves para más de un carácter |
| Subíndice | a_1, x_{n+1} |
|
| Fracción | \frac{a}{b} |
\dfrac para una fracción más grande en línea |
| Raíz cuadrada | \sqrt{x}, \sqrt[3]{x} |
|
| Sumatorio, productorio | \sum_{i=1}^{n} i, \prod_{k} k |
|
| Integral | \int_0^1 x\,dx |
\, añade un espacio fino |
| Límite | \lim_{x \to 0} \frac{\sin x}{x} |
|
| Letras griegas | \alpha, \beta, \pi, \Omega |
Inicial en mayúscula para la letra mayúscula |
| Relaciones | \le, \ge, \ne, \approx, \equiv |
|
| Operadores | \times, \cdot, \pm, \div |
|
| Conjuntos | \in, \subset, \cup, \cap, \mathbb{R} |
|
| Flechas | \to, \Rightarrow, \leftrightarrow |
|
| Texto dentro de una fórmula | \text{if } x > 0 |
Mantiene el espaciado normal |
| Vectores, acentos | \vec{v}, \hat{x}, \bar{y} |
Las llaves agrupan: x^10 se muestra como x¹0, mientras que x^{10} se muestra como x¹⁰. Cuando una fórmula sale mal, la causa más habitual son las llaves que faltan.
Paréntesis que crecen
Los paréntesis normales mantienen su tamaño. Usa \left y \right para que envuelvan contenido alto:
latex\left( \frac{a}{b} \right)^2 \quad \text{vs} \quad (\frac{a}{b})^2
Matrices
Las matrices usan entornos. pmatrix añade paréntesis, bmatrix corchetes y vmatrix barras verticales (un determinante). Las columnas se separan con & y las filas con \\.
latex$$
A = \begin{pmatrix}
1 & 2 \\
3 & 4
\end{pmatrix}
$$
Ecuaciones en varias líneas y alineadas
Para alinear varios pasos en el signo igual, usa el entorno aligned dentro de una fórmula destacada y marca el punto de alineación con &:
latex$$
\begin{aligned}
(a + b)^2 &= (a + b)(a + b) \\
&= a^2 + 2ab + b^2
\end{aligned}
$$
Para funciones definidas a trozos, usa cases:
latex$$
|x| = \begin{cases}
x & \text{if } x \ge 0 \\
-x & \text{if } x < 0
\end{cases}
$$
Signos de dólar que no son fórmulas
Los precios en un texto pueden convertirse sin querer en fórmulas. La mayoría de los renderizadores siguen la regla de Pandoc: el $ de apertura no debe ir seguido de un espacio, y el $ de cierre no debe ir precedido de un espacio ni seguido de un dígito. Por eso «entre $5 y $10» suele quedarse como texto normal. Si tienes dudas, escapa el signo de dólar: \$5.
KaTeX frente a MathJax
Ambos renderizan la misma sintaxis LaTeX; la diferencia está sobre todo en la velocidad y la cobertura.
- KaTeX es rápido y renderiza de forma síncrona, lo que resulta ideal para una vista previa en directo. Admite la gran mayoría de los comandos que se usan en documentación, apuntes y artículos.
- MathJax admite un conjunto más amplio de paquetes LaTeX y lo usan GitHub y muchos sitios académicos, pero es más pesado.
Markdown Preview Editor usa KaTeX y solo lo carga cuando un documento contiene realmente una fórmula, así que los documentos sin fórmulas siguen siendo ligeros. Una fórmula escrita para KaTeX casi siempre se mostrará bien también en GitHub.
Fórmulas en GitHub
GitHub renderiza fórmulas en archivos Markdown, issues y pull requests. Admite $…$ y $$…$$, además de dos alternativas para casos complicados: $`…`$ para fórmulas en línea que contienen caracteres que Markdown interpretaría, y un bloque de código delimitado con el lenguaje math para ecuaciones destacadas.
Escribir fórmulas más rápido
- Usa el botón de fórmula matemática de la barra del editor avanzado de Markdown Preview Editor para insertar una plantilla y edítala con la vista previa al lado.
- Ten un archivo de fragmentos con las fórmulas que usas a menudo: matrices, bloques alineados,
cases. - Combina las fórmulas con diagramas Mermaid para explicar algoritmos: un diagrama de flujo para los pasos y una fórmula para cada paso.
- Cuando el documento esté listo, expórtalo a HTML o PDF: las fórmulas se conservan en el archivo exportado.
¿Eres nuevo en Markdown? Empieza por la chuleta de Markdown.
Preguntas frecuentes
¿Cómo escribo una ecuación en Markdown?
Rodea la fórmula LaTeX con un signo de dólar para fórmulas en línea ($a^2 + b^2 = c^2$) o con dos para una ecuación destacada y centrada. La herramienta de Markdown debe admitir fórmulas; GitHub, GitLab, Obsidian, Jupyter y Markdown Preview Editor lo hacen.
¿Por qué mi fórmula aparece como texto normal?
Motivos habituales: la herramienta no admite fórmulas, hay un espacio justo después del $ de apertura o justo antes del $ de cierre, o un carácter de Markdown como _ o * dentro de la fórmula se ha interpretado como formato. Prueba con una fórmula destacada con $$ en líneas separadas.
¿Cómo escribo una matriz en Markdown?
Usa \begin{pmatrix} … \end{pmatrix} (o bmatrix, vmatrix) dentro de $$. Separa las columnas con & y las filas con \\.
¿KaTeX admite todos los comandos de LaTeX?
KaTeX admite la mayoría de los comandos matemáticos que se usan en la práctica, pero no todos los paquetes de LaTeX. Los comandos de maquetación del documento (como \section o \usepackage) no se aplican en absoluto a las fórmulas de Markdown.