§0 Una extensión gratuita para VS Code
Mirá tus fórmulas mientras las escribís.
Math Inline muestra las fórmulas $…$ y $$…$$ renderizadas dentro del propio editor de Markdown, no solo en la vista previa. Poné el cursor en una fórmula para editar su TeX. Salí de ella y se vuelve a renderizar.
ext install polecoder.math-inline
Pegalo en Quick Open (Ctrl+P) en VS Code. Requiere VS Code 1.90 o posterior.
- Escribí TeX
- Salí: se renderiza
- Hacé clic: editá
§1 Antes / después
El mismo archivo. Ahora se puede leer.
Arrastrá el control. A la derecha está tu Markdown como lo muestra VS Code por defecto. A la izquierda, el mismo archivo con Math Inline activado. El texto guardado en disco es idéntico.
§2 Funciones
Hecha para quienes piensan en TeX.
Cada tarjeta tiene una pequeña demo en vivo. Pasá el mouse por encima o llegá a ella con el tabulador.
-
Euler: $e^{i\pi} + 1 = 0$Edición en el lugar
Llevá el cursor a una fórmula y vuelve a aparecer su TeX, con una vista previa en vivo después del $ de cierre. Si el TeX está a medio escribir, la vista previa conserva la última versión que se pudo renderizar.
-
Un medio: $\frac{1}{2$Errores subrayados
El TeX inválido se subraya con una línea ondulada, incluso mientras lo escribís. Pasá el mouse por encima para leer el error. Pasalo sobre el código de una fórmula para verla renderizada en grande.
-
$R = \begin{pmatrix}…\end{pmatrix}$“∑ show formula”
Las fórmulas demasiado altas para una línea, como matrices o fracciones apiladas, se pliegan en una etiqueta. Pasá el mouse sobre ella para ver la fórmula completa en modo display.
-
$$ \begin{aligned} … \end{aligned} $$Tablas, fila por fila
Los bloques
$$de varias líneas conaligned,cases,arrayo matrices se dibujan una fila por línea, con las columnas alineadas. Editá una fila y las demás siguen renderizadas. -
Almuerzo $5, café $10 y $x^2$.Entiende los signos de dólar
Sigue las reglas de Pandoc, así que
$5 y $10queda como texto. El\$escapado, el código, el front matter, el HTML y las URL de los enlaces no se tocan. -
\bboxse renderiza aquí, pero la vista previa de Markdown de VS Code (KaTeX) no puede renderizarlo. notes.md [Ln 12, Col 4]Avisos de compatibilidad con KaTeX
Math Inline renderiza con MathJax, pero la vista previa integrada de VS Code usa KaTeX. Cuando una fórmula usa algo que KaTeX no puede renderizar, como
\bbox, un aviso en el panel Problemas señala el comando. Se desactiva conmathInline.katexWarnings.
§3 Zona de pruebas
Funciona como vos escribís.
Escribí Markdown con $…$ y $$…$$ y mirá cada línea renderizada en su lugar. Usa las mismas reglas para el signo $ que la extensión. Esta página usa KaTeX; la extensión usa MathJax.
Cada línea se renderiza por separado. El TeX inválido se subraya.
En el editor, con Math Inline
§4 Configuración
Cuatro opciones. Un atajo.
Los valores por defecto le sirven a la mayoría. Si querés cambiarlos, van en tu settings.json.
{
// Renderiza las fórmulas $…$ y $$…$$ en editores de Markdown.
"mathInline.enabled": true,
// Tamaño de las fórmulas respecto a la fuente del editor (0.25–4).
"mathInline.scale": 1,
// Color CSS, p. ej. "#ffcc00". Vacío = según el tema.
"mathInline.color": "",
// Avisa de fórmulas que la vista previa (KaTeX) no puede renderizar.
"mathInline.katexWarnings": true
}Mostrar u ocultar todas las fórmulas
Pulsá Ctrl+Alt+M (Cmd+Alt+M en macOS) en un editor de Markdown para ver el código TeX de todas las fórmulas. Volvé a pulsarlo para renderizarlas.
El comando se llama Math Inline: Toggle Inline Math Rendering. Para cambiar el atajo, buscá mathInline.toggle en Métodos abreviados de teclado.
§5 Limitaciones conocidas, con honestidad
- VS Code no permite cambiar la altura de las líneas. Las fórmulas altas se reducen para que quepan en la línea o se pliegan en una etiqueta “∑ show formula”. Usá
mathInline.scalepara cambiar el tamaño general. - Los bloques $$ de varias líneas se dibujan dentro de las líneas que ya ocupan. Las filas altas pueden superponerse a las líneas vacías vecinas, y las líneas con $$, \begin y \end quedan en blanco.
- Solo se renderizan las fórmulas cercanas a la zona visible. Si te desplazás muy rápido, podés ver el TeX por un instante.
- Con el ajuste de línea activado, VS Code corta las líneas según la longitud del TeX oculto, así que las líneas con muchas fórmulas pueden cortarse antes de tiempo.
§6 Preguntas
Preguntas frecuentes
¿Es gratis?
Sí. Math Inline es gratuita y de código abierto, con licencia MIT. No hay cuentas, ni telemetría, ni versión de pago.
¿Funciona en Cursor o VSCodium?
Math Inline está publicada en Visual Studio Marketplace y requiere VS Code 1.90 o posterior. Los editores basados en VS Code no siempre usan el mismo registro de extensiones. Si no la encontrás en el tuyo, abrí un issue en GitHub.
¿Modifica mis archivos?
No. Solo cambia lo que ves en el editor. Tus archivos .md siguen siendo Markdown y TeX planos, y Git no ve ningún cambio.
¿Reemplaza la vista previa de Markdown?
No, la vista previa sigue funcionando. Math Inline renderiza dentro del editor con MathJax. También puede avisarte cuando una fórmula no se va a renderizar en la vista previa, que usa KaTeX.
Escribí un precio y se convirtió en fórmula. O al revés.
La extensión sigue las reglas de Pandoc. El $ de apertura no puede ir seguido de un espacio. El $ de cierre no puede ir después de un espacio ni seguido de un dígito. Escribí \$ para un signo de dólar literal.