Printdown

Fórmulas en Markdown: escribe LaTeX y exporta a PDF

Por ·

Markdown no tiene una sintaxis propia para las matemáticas, pero casi todos los editores que admiten fórmulas comparten una convención: LaTeX entre signos de dólar. El editor de Markdown a PDF la sigue y compone cada fórmula con KaTeX en tu navegador, sin instalar TeX. Aquí tienes la sintaxis que entiende, una referencia rápida para copiar, cómo evitar que los precios se conviertan en fórmulas y cómo llevar las ecuaciones al papel sin sorpresas.

Fórmulas en línea y en bloque

Con un signo de dólar a cada lado, la fórmula queda dentro de la frase; con dos, ocupa su propia línea, centrada:

El área de un círculo es $A = \pi r^2$ y su perímetro, $P = 2\pi r$.

$$
\int_0^1 x^2\,dx = \frac{1}{3}
$$

Unas pocas reglas deciden si un dólar abre una fórmula:

  • Las fórmulas en bloque van en líneas propias. Pon $$ en la línea anterior y en la siguiente, o todo en una sola línea: $$ a^2 + b^2 = c^2 $$. Un par $$…$$ en mitad de una frase se convierte igualmente en un bloque aparte y parte el párrafo.
  • Ni letras ni cifras justo después del dólar de cierre. $v = 5$m/s se queda como texto plano; deja un espacio, $v = 5$ m/s, o mete la unidad en la fórmula: $v = 5\ \text{m/s}$. La puntuación no molesta: ($x$) y $x$, funcionan.
  • Solo cuentan los signos de dólar. Los delimitadores \(…\) y \[…\] de LaTeX, habituales también al copiar respuestas de asistentes de IA, se ven como paréntesis y corchetes normales, y un bloque ```math al estilo de GitHub aparece como código. Cámbialos por $…$ y $$…$$.
  • Markdown no se mete en las fórmulas. Los guiones bajos y los asteriscos dentro de una fórmula nunca se convierten en cursiva ni en negrita.

Referencia rápida

Todo lo que sigue va entre signos de dólar. Agrupa con llaves todo lo que tenga más de un carácter: x^{10}, porque x^10 solo eleva el 1.

QuieresEscribes
Exponente, subíndicex^2, a_n, x_{i,j}^{2k}
Fracción\frac{a+b}{2}, o \dfrac para tamaño completo dentro de una frase
Raíces\sqrt{x}, \sqrt[3]{x}
Letras griegas\alpha \beta \gamma \theta \lambda \pi \sigma \omega \Delta \Sigma \Omega
Sumatorio y productorio\sum_{i=1}^{n} i, \prod_{k=1}^{n} k
Integrales\int_a^b f(x)\,dx, \iint_D, \oint_C
Límite\lim_{x \to 0} \frac{\operatorname{sen} x}{x}
Derivadasf'(x), \frac{dy}{dx}, \frac{\partial f}{\partial x}
Relaciones, operadores\le \ge \ne \approx \equiv \pm \times \cdot \div \infty
Lógica y conjuntos\forall \exists \in \notin \subset \cup \cap \Rightarrow \iff
Conjuntos numéricos\mathbb{R}, \{ x \mid x > 0 \}
Paréntesis que crecen\left( \frac{a}{b} \right)
Valor absoluto, norma\lvert x \rvert, \lVert v \rVert
Negrita, acentos\mathbf{v}, \boldsymbol{\alpha}, \hat{x} \bar{x} \vec{v}
Funciones\cos x, \log_2 n, \operatorname{sen} x
Palabras en una fórmula\text{si } x > 0
Espaciosa\,b, a \quad b, a \qquad b
Decimales con coma3{,}14
Porcentaje, dólar, grados5\%, \$5, 90^\circ
Número combinatorio\binom{n}{k}

Dos detalles para quien escribe en español. KaTeX solo trae \sin, en inglés; para el «sen» de los libros de texto usa \operatorname{sen} x, que mantiene la letra recta y el espaciado de una función. Y en una fórmula la coma cuenta como puntuación, así que 3,14 sale con un espacio detrás; las llaves de 3{,}14 lo evitan.

Matrices

$$
A = \begin{pmatrix} 1 & 2 \\ 3 & 4 \end{pmatrix}
\qquad
\det A = \begin{vmatrix} 1 & 2 \\ 3 & 4 \end{vmatrix} = -2
$$

& separa columnas y \\ termina una fila. pmatrix, bmatrix, vmatrix y matrix ponen paréntesis, corchetes, las barras de un determinante o ningún delimitador.

Ecuaciones de varias líneas

Usa aligned para un desarrollo paso a paso: & marca el punto en el que se alinean las líneas, normalmente justo antes del signo igual, y \\ empieza una línea nueva.

$$
\begin{aligned}
(a+b)^2 &= (a+b)(a+b) \\
        &= a^2 + 2ab + b^2
\end{aligned}
$$

aligned y align* no llevan número. align, gather y equation numeran sus líneas automáticamente, (1), (2), (3) a lo largo de todo el documento, y \tag{2.1} pone un número a mano. No existen \label ni \eqref: cita las ecuaciones por su número.

Funciones definidas a trozos

$$
\lvert x \rvert =
\begin{cases}
  x  & \text{si } x \ge 0 \\
  -x & \text{si } x < 0
\end{cases}
$$

Rodea las condiciones con \text{}: en modo matemático se ignoran los espacios y las letras salen en cursiva, como variables. Dentro de \text{} puedes usar tildes y eñes sin problema.

Precios que no son fórmulas

El editor se esfuerza en no confundir precios con fórmulas. Un signo de dólar solo abre una fórmula si no lleva una letra o una cifra justo delante, y solo la cierra si no lleva una letra o una cifra justo detrás. Por eso Precios: $5.000, $12.500 y $20.000., como se escribe en los países que usan $ para el peso, se imprime tal cual, y US$ 20 también es seguro.

El problema aparece cuando el símbolo va detrás de la cantidad: en Cuesta 5 $ hoy y 10 $ mañana. los dos dólares se emparejan, y «hoy y 10» se convierte en cursiva sin espacios. Dos soluciones:

  • Escapa el signo con una barra invertida, que no aparece en el resultado: Cuesta 5 \$ hoy y 10 \$ mañana.
  • O pon el importe como código en línea, `5 $`, a costa de cambiar la fuente.

Dentro de una fórmula, \$ también produce un signo de dólar: $\text{total} = \$12 \times n$.

KaTeX no es LaTeX completo

KaTeX implementa el modo matemático de LaTeX, no todo el sistema de composición. Las fórmulas de un archivo .tex suelen funcionar sin cambios; lo que pertenece al documento y no a la fórmula, no:

  • Ni preámbulo ni paquetes. \documentclass, \usepackage y \begin{document} aquí no significan nada, y los comandos de paquetes como \SI (siunitx), \ce (mhchem) o \DeclareMathOperator no están disponibles. Escribe las unidades como texto, 9{,}8\ \text{m/s}^2, la química sencilla como \mathrm{H_2O} y los operadores propios con \operatorname{sen}.
  • Faltan algunos entornos. aligned, align, gather, cases, array y las matrices funcionan; multline, eqnarray y tabular, no. Usa aligned, o una tabla Markdown para datos tabulares, y deja align, gather y equation en bloques $$.
  • Sin referencias cruzadas, enlaces ni imágenes. \label, \ref, \eqref, \href, \url e \includegraphics aparecen en rojo; pon los enlaces y las imágenes en el Markdown que rodea la fórmula.
  • Las macros duran una fórmula. \newcommand y \def funcionan, pero cada fórmula empieza de cero, así que define el atajo en el mismo bloque que lo usa:
    $$
    \newcommand{\abs}[1]{\left\lvert #1 \right\rvert}
    \abs{x - 1} < \abs{x + 1}
    $$

Si tienes dudas, consulta la lista de funciones admitidas de KaTeX o su tabla de compatibilidad por orden alfabético (ambas en inglés).

Cómo llevar las ecuaciones al papel

  • Tamaño. Las fórmulas siguen el ajuste Tamaño de letra del panel Estilo y se dibujan algo más grandes que el texto. Los subíndices son lo primero que se vuelve ilegible, así que en páginas con muchas matemáticas no bajes de 11 pt.
  • Fuentes. Las matemáticas usan las fuentes de KaTeX, de estilo Computer Modern, en todos los temas y con el color de texto del tema. Los temas con serifa, Classic y Editorial, son los que mejor combinan con ellas.
  • Ancho. Las ecuaciones en bloque nunca se parten. Si una es más ancha que la columna de texto, en la vista previa aparece una barra de desplazamiento y en el PDF queda cortada por el borde derecho, así que divídela con aligned o elige márgenes Estrechos. Las fórmulas en línea pueden saltar de línea después de un igual o de un más, como el texto.
  • Saltos de página. El navegador mantiene cada ecuación en bloque de una pieza, incluso un aligned de diez líneas; si no cabe, pasa entera a la página siguiente y deja un hueco. Para decidir dónde termina cada página, pon <!-- pagebreak -->, \pagebreak o \newpage solo en una línea, fuera de cualquier fórmula.
  • Exportación. Haz clic en Descargar PDF y elige Guardar como PDF: las matemáticas se imprimen como texto y trazos vectoriales, nítidas con cualquier zoom. Evita Más → PDF rápido para las fórmulas; guarda las páginas como imágenes, así que pierden nitidez y una ecuación que caiga en el límite entre dos páginas puede quedar cortada.

Deberes, apuntes y borradores de artículos

En una hoja de ejercicios, dale a cada ejercicio un título ## con la solución debajo, y pon un salto de página entre ejercicios:

# Hoja de ejercicios 3 — Cálculo I

**Nombre:** Lucía Pérez · **Entrega:** 14 de marzo

## Ejercicio 1

Calcula $\displaystyle\lim_{x \to 0} \frac{\operatorname{sen} 3x}{x}$.

**Solución.** Con el cambio $u = 3x$:

$$
\lim_{x \to 0} \frac{\operatorname{sen} 3x}{x} = 3 \lim_{u \to 0} \frac{\operatorname{sen} u}{u} = 3
$$

<!-- pagebreak -->

## Ejercicio 2

\displaystyle compone un límite o un sumatorio en línea a tamaño completo, con los límites debajo. Si tomas los apuntes de clase en Obsidian o Notion, la guía para exportar notas a PDF explica cómo traerlos; las fórmulas entre dólares llegan intactas.

Para el borrador de un artículo, el editor es una forma rápida de enviar ecuaciones legibles a un coautor o a tu director de tesis. Cuando la versión final necesite la plantilla de una revista, una bibliografía o referencias cruzadas numeradas, pasa a una instalación completa de LaTeX; tus fórmulas te acompañan casi sin cambios, porque ya son LaTeX.

Solución de problemas

  • La fórmula entera sale en rojo, como código fuente. KaTeX no ha podido interpretarla; pasa el ratón por encima para leer el error. Causas habituales: falta una }, hay un \begin{…} sin su \end{…}, un & fuera de un entorno de alineación o un entorno que KaTeX no tiene.
  • Un comando sale en rojo y el resto se ve bien. KaTeX no lo conoce: revisa cómo está escrito (\alpah) o sustituye el comando de paquete.
  • Los dólares aparecen como texto. Los delimitadores no se han emparejado: busca una letra o una cifra justo después del $ de cierre, una fórmula entre comillas invertidas o \(…\). La primera fórmula también puede tardar un momento, porque el motor de matemáticas solo se descarga cuando un documento lo necesita.
  • Una celda de tabla se rompe. En una tabla Markdown, | cierra la celda aunque esté dentro de una fórmula; escribe \lvert x \rvert en lugar de |x|.
  • Falta media fórmula. % inicia un comentario en LaTeX, así que $50% de x$ solo muestra «50». Escribe \%.

Todo, incluido el renderizado de las fórmulas, ocurre en tu navegador, así que tus deberes y tu investigación sin publicar nunca salen de tu dispositivo. Para el resto de la sintaxis, consulta la guía de Markdown.

Más guías