De LaTeX a MathML
Convierta una fórmula de LaTeX en marcado MathML con KaTeX 0.19.1. El resultado es un único elemento math con MathML de presentación y el LaTeX original como anotación, en modo de visualización o en línea, listo para pegar en documentos HTML, EPUB o XML. MathML se representa de forma nativa en las versiones actuales de Chrome, Edge, Firefox y Safari, y los lectores de pantalla lo leen en voz alta, por lo que sus fórmulas siguen siendo accesibles sin JavaScript.
Preguntas frecuentes
¿Qué aspecto tiene el resultado?
Se obtiene un único elemento math en el espacio de nombres MathML, con un contenedor semantics. En su interior hay MathML de presentación compuesto por elementos como mi, mn, mo, mfrac, msup y mtable, seguido de una anotación con la codificación application/x-tex que contiene el LaTeX original. El modo de visualización añade display="block" al elemento math.
¿Dónde puedo usar MathML?
Péguelo directamente en una página HTML5, un libro EPUB 3, XHTML o un formato XML como JATS o DocBook. Muchos editores de ecuaciones y suites ofimáticas también pueden importar MathML, lo que lo convierte en un formato práctico para intercambiar contenido entre herramientas que no leen LaTeX.
¿Los navegadores muestran MathML?
Sí. Chrome y Edge desde la versión 109, Firefox y Safari representan MathML de forma nativa, sin scripts ni hojas de estilos. Los navegadores lo dibujan con sus propias fuentes matemáticas, por lo que su aspecto difiere ligeramente de la representación HTML de KaTeX, pero la estructura y las reglas de espaciado son las mismas.
¿Cuál es la diferencia entre el modo de visualización y el modo en línea?
El modo de visualización marca la fórmula con display="block", de modo que se presenta como una ecuación independiente, con fracciones de tamaño completo y límites arriba y abajo de los operadores grandes. El modo en línea omite el atributo y presenta la fórmula en el estilo compacto pensado para el texto corrido.
¿Se conserva mi LaTeX original?
Sí. KaTeX guarda el código fuente en un elemento annotation dentro del contenedor semantics. Los navegadores no lo muestran, pero las herramientas de copia y otros conversores pueden usarlo para recuperar el LaTeX exacto. Elimine el elemento annotation si no quiere incluir el código fuente en el documento.
¿Qué comandos de LaTeX se admiten?
Todo lo que admite KaTeX 0.19.1, incluidas fracciones, raíces, matrices, entornos como aligned, cases y array, acentos, flechas, comandos de fuente como \mathbb y \mathcal, \text y \tag. También funcionan las macros que defina con \def o \newcommand dentro de la fórmula. No se admiten documentos completos, \usepackage ni los comandos \ce de mhchem.
¿Qué ocurre si la fórmula contiene un error?
No se devuelve MathML. La herramienta indica el problema y el carácter donde se produce, contando desde 1; por ejemplo, un comando desconocido, llaves sin pareja, un superíndice doble o un comando al que le falta su argumento.
¿Hay algún límite?
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 y \kern están limitados a 100em. Los comandos que enlazan o cargan contenido externo, como \href, \url y \includegraphics, están desactivados y aparecen como texto no admitido.
¿Es MathML adecuado para la accesibilidad?
Sí. Los lectores de pantalla como VoiceOver, NVDA y JAWS pueden leer MathML y permitir que los usuarios recorran una fórmula paso a paso, algo que una imagen no ofrece. Mantener las fórmulas como MathML en vez de imágenes es una de las formas más sencillas de hacer accesible el contenido técnico.
¿En qué se diferencia de la salida habitual de KaTeX?
En una página web, KaTeX suele generar HTML con estilos para mostrar y MathML oculto para lectores de pantalla. Esta herramienta devuelve solo la parte MathML, exactamente como la genera KaTeX, sin el span contenedor, la hoja de estilos ni las fuentes, por lo que funciona en cualquier lugar donde se entienda MathML.