Vai al contenuto

LaTeX in MathML

Convertite una formula LaTeX in markup MathML con KaTeX 0.19.1. Il risultato è un unico elemento math con MathML di presentazione e il LaTeX originale conservato come annotazione, in modalità display o inline, pronto da incollare in HTML, nei documenti EPUB o XML. MathML viene visualizzato in modo nativo nelle versioni attuali di Chrome, Edge, Firefox e Safari ed è letto ad alta voce dagli screen reader, così le formule rimangono accessibili senza JavaScript.

Reimposta

Domande frequenti

Che aspetto ha il risultato?

Si ottiene un singolo elemento math nello spazio dei nomi MathML, con un wrapper semantics. Al suo interno si trova MathML di presentazione composto da elementi come mi, mn, mo, mfrac, msup e mtable, seguito da un'annotazione con l'encoding application/x-tex che contiene il LaTeX originale. La modalità display aggiunge display="block" all'elemento math.

Dove posso usare MathML?

Incollatelo direttamente in una pagina HTML5, un libro EPUB 3, XHTML o un formato XML come JATS o DocBook. Molti editor di equazioni e suite per ufficio possono importare MathML, che diventa così un pratico formato di scambio tra strumenti che non leggono LaTeX.

I browser visualizzano MathML?

Sì. Chrome ed Edge dalla versione 109, Firefox e Safari visualizzano MathML in modo nativo, senza script o fogli di stile. I browser lo disegnano con i propri font matematici, quindi l'aspetto è leggermente diverso dal rendering HTML di KaTeX, ma la struttura e le regole di spaziatura sono le stesse.

Qual è la differenza tra modalità display e inline?

La modalità display contrassegna la formula con display="block", che viene quindi composta come equazione indipendente, con frazioni a dimensione intera e i limiti sopra e sotto gli operatori grandi. La modalità inline omette l'attributo e compone la formula nello stile compatto pensato per il testo corrente.

Il mio LaTeX originale viene conservato?

Sì. KaTeX memorizza il sorgente in un elemento annotation all'interno del wrapper semantics. I browser non lo visualizzano, ma gli strumenti di copia e altri convertitori possono usarlo per recuperare il LaTeX esatto. Rimuovete l'elemento annotation se non volete includere il sorgente nel documento.

Quali comandi LaTeX sono supportati?

Tutti quelli supportati da KaTeX 0.19.1, comprese frazioni, radici, matrici, ambienti come aligned, cases e array, accenti, frecce, comandi per i caratteri come \mathbb e \mathcal, \text e \tag. Funzionano anche le macro definite con \def o \newcommand all'interno della formula. I documenti completi, \usepackage e i comandi \ce di mhchem non sono disponibili.

Che cosa succede se la formula contiene un errore?

Non viene restituito alcun MathML. Lo strumento segnala il problema e il carattere in cui si verifica, contando da 1; per esempio, un comando sconosciuto, parentesi graffe non bilanciate, un doppio apice o un comando a cui manca l'argomento.

Ci sono dei limiti?

Una formula può contenere fino a 10,000 caratteri, le macro possono espandersi al massimo 1,000 volte e le dimensioni indicate a comandi come \rule e \kern sono limitate a 100em. I comandi che collegano o caricano contenuti esterni, come \href, \url e \includegraphics, sono disattivati e vengono restituiti come testo non supportato.

MathML è adatto all'accessibilità?

Sì. Gli screen reader come VoiceOver, NVDA e JAWS possono leggere MathML e consentire ai lettori di esplorare una formula un elemento alla volta, cosa impossibile con un'immagine. Mantenere le formule in MathML anziché trasformarle in immagini è uno dei modi più semplici per rendere accessibili i contenuti tecnici.

In che cosa differisce dal normale output di KaTeX?

In una pagina web, KaTeX normalmente genera HTML per la visualizzazione, oltre a MathML nascosto per gli screen reader. Questo strumento restituisce solo la parte MathML, esattamente come la genera KaTeX, senza lo span contenitore, il foglio di stile o i font, così funziona ovunque sia supportato MathML.

Informazioni su OneClick Pro

OneClick Pro è una raccolta gratuita di oltre 150 strumenti web per le attività quotidiane: convertire immagini e unità di misura, formattare e convalidare codice, controllare domini e SEO, lavorare con testi, date e numeri. Ogni strumento funziona senza registrazione né abbonamento; i dati inseriti vengono usati solo per calcolare il risultato e non vengono mai salvati. Usatelo come cassetta degli attrezzi per attività occasionali oppure aggiungete ai preferiti gli strumenti che usate ogni giorno.