LaTeX para MathML
Converta uma fórmula LaTeX em marcação MathML com KaTeX 0.19.1. O resultado é um único elemento math com MathML de apresentação e seu LaTeX original preservado como anotação, nos modos de exibição ou em linha, pronto para ser colado em documentos HTML, EPUB ou XML. O MathML é renderizado nativamente nas versões atuais de Chrome, Edge, Firefox e Safari, e leitores de tela o leem em voz alta; assim, suas fórmulas permanecem acessíveis sem JavaScript.
Perguntas frequentes
Como é a saída?
Você recebe um único elemento math no namespace MathML, com um elemento wrapper semantics. Dentro dele há MathML de apresentação, composto por elementos como mi, mn, mo, mfrac, msup e mtable, seguido de uma anotação com a codificação application/x-tex que contém seu LaTeX original. O modo de exibição adiciona display="block" ao elemento math.
Onde posso usar o MathML?
Cole-o diretamente em uma página HTML5, um livro EPUB 3, XHTML ou um formato XML como JATS ou DocBook. Muitos editores de equações e suítes de escritório também podem importar MathML, o que o torna um formato prático de intercâmbio entre ferramentas que não leem LaTeX.
Os navegadores exibem MathML?
Sim. Chrome e Edge a partir da versão 109, Firefox e Safari renderizam MathML nativamente, sem scripts ou folhas de estilos. Os navegadores o desenham com suas próprias fontes matemáticas; por isso, a aparência é um pouco diferente da renderização HTML do KaTeX, mas as regras de estrutura e espaçamento são as mesmas.
Qual é a diferença entre os modos de exibição e em linha?
O modo de exibição marca a fórmula com display="block", que é apresentada como uma equação independente, com frações em tamanho normal e limites acima e abaixo dos operadores grandes. O modo em linha omite o atributo, e a fórmula é apresentada no estilo compacto pensado para texto corrido.
Meu LaTeX original é preservado?
Sim. O KaTeX armazena o código-fonte em um elemento annotation dentro do elemento wrapper semantics. Os navegadores não o exibem, mas ferramentas de cópia e outros conversores podem usá-lo para recuperar o LaTeX exato. Remova o elemento annotation se não quiser que o código-fonte fique no documento.
Quais comandos LaTeX são compatíveis?
Tudo o que o KaTeX 0.19.1 suporta, incluindo frações, raízes, matrizes, ambientes como aligned, cases e array, acentos, setas, comandos de fonte como \mathbb e \mathcal, \text e \tag. Também funcionam as macros que você definir com \def ou \newcommand dentro da fórmula. Documentos completos, \usepackage e os comandos \ce do mhchem não estão disponíveis.
O que acontece quando há um erro na fórmula?
Nenhum MathML é retornado. A ferramenta informa o problema e o caractere em que ele ocorre, contado a partir de 1, por exemplo, um comando desconhecido, chaves sem correspondência, um sobrescrito duplo ou um comando sem argumento.
Há algum limite?
Uma fórmula pode ter até 10,000 caracteres, as macros podem ser expandidas no máximo 1,000 vezes, e os tamanhos passados a comandos como \rule e \kern são limitados a 100em. Comandos que vinculam ou carregam conteúdo externo, como \href, \url e \includegraphics, estão desativados e são exibidos como texto não compatível.
O MathML é bom para acessibilidade?
Sim. Leitores de tela como VoiceOver, NVDA e JAWS conseguem ler MathML e permitem que as pessoas percorram uma fórmula parte por parte, algo que uma imagem não oferece. Manter a matemática em MathML em vez de imagens é uma das maneiras mais simples de tornar acessível o conteúdo técnico.
Em que isso difere da saída normal do KaTeX?
Em uma página da Web, o KaTeX normalmente gera HTML estilizado para exibição, além de MathML oculto para leitores de tela. Esta ferramenta retorna apenas a parte em MathML, exatamente como o KaTeX a gera, sem o span envolvente, a folha de estilos ou as fontes, para que funcione em qualquer lugar onde MathML seja entendido.