De LaTeX a SVG

KaTeX compone la fórmula como HTML en el servidor, y la herramienta incluye ese HTML en un foreignObject de SVG junto con la hoja de estilos de KaTeX y los archivos de fuentes woff2 que necesita la fórmula, incrustados como URL de datos. La anchura y la altura se obtienen de las métricas tipográficas de KaTeX y de la anchura real de los glifos de esas fuentes, de modo que el lienzo se ajusta a la fórmula con un pequeño margen.

Se muestra en Chrome, Edge, Firefox y Safari, ya sea que se use como elemento img, fondo CSS, marcado SVG en línea o se abra el archivo directamente, y en aplicaciones creadas con un motor de navegador. Los editores y conversores vectoriales como Inkscape, Illustrator, la importación de SVG de Figma, librsvg y resvg no renderizan HTML dentro de foreignObject, por lo que la fórmula aparece en blanco.

Ninguna biblioteca con licencia permisiva de las que usa esta herramienta compone las fórmulas de KaTeX como contornos de glifos, y un sistema de composición independiente no reproduciría el resultado de KaTeX. Incrustar el propio HTML de KaTeX conserva el espaciado y las fuentes exactos. Si un editor vectorial necesita contornos, abra el SVG en un navegador e imprímalo en PDF; así la fórmula se conserva como formas vectoriales que los editores pueden importar.

El modo de visualización compone la fórmula como una ecuación independiente: los operadores grandes llevan sus límites arriba y abajo, las fracciones mantienen su tamaño completo y se permiten los números \tag. El modo en línea usa el estilo compacto de texto pensado para fórmulas dentro de una oración, con fracciones más pequeñas y límites junto a las sumas y las integrales.

Establece el tamaño de la fuente matemática en píxeles, de 8 a 200, como número entero; el valor predeterminado es 24. El ancho y la altura del SVG aumentan proporcionalmente, por lo que una fórmula renderizada a 48 píxeles es el doble de grande que una de 24. Como el resultado es vectorial, puede cambiar su tamaño más adelante con CSS.

Todo lo que admite KaTeX 0.19.1: fracciones, raíces, sumas e integrales, matrices y entornos como aligned, cases, pmatrix y array, acentos, flechas, \mathbb, \mathcal, \mathfrak, \text, \color y \tag. Puede definir sus propias macros con \def o \newcommand dentro de la fórmula. No se admiten documentos completos, \usepackage, TikZ ni los comandos \ce de mhchem.

No se genera ningún archivo y la herramienta indica qué ha fallado y en qué carácter, contando desde 1. Señala los comandos desconocidos, las llaves sin pareja, los superíndices dobles y los comandos a los que les falta un argumento, para que pueda ir directamente al punto y corregirlo.

La fórmula puede tener hasta 10,000 caracteres, las macros pueden expandirse como máximo 1,000 veces y los tamaños indicados en comandos como \rule, \kern y \hspace están limitados a 100em. Los comandos que cargan o enlazan contenido externo, como \href, \url y \includegraphics, están desactivados y aparecen como texto rojo no admitido.

El fondo es transparente. Al pegar el marcado SVG en una página HTML, la fórmula adopta el color del texto del elemento que la rodea; como archivo de imagen, se dibuja en negro. Use \color o \textcolor dentro de la fórmula para establecer colores que permanezcan fijos en todas partes.

Cada archivo incluye la hoja de estilos de KaTeX, de unos 24 KB, y cada tipo de fuente que utiliza la fórmula, codificado en base64 woff2, por lo que una fórmula típica ocupa entre 75 y 150 KB. Los caracteres que no están en las fuentes de KaTeX, como el chino o el japonés dentro de \text, usan las fuentes del propio visor. El SVG tiene el rol img, el código fuente de LaTeX como título y una etiqueta aria-label para lectores de pantalla.