MathML: Browser Support, Elements, Known Issues

What is MathML?

MathML is the Mathematical Markup Language, an XML-based standard from the W3C for describing mathematical notation. The browser-focused subset is MathML Core, which integrates with HTML, CSS, the DOM, and JavaScript. The current version is MathML 4, while MathML 3 remains a W3C Recommendation.

Which browsers does MathML support?

MathML works in every modern browser. Firefox, Safari, Chrome, Edge, Opera, and Samsung Internet ship MathML by default, while Internet Explorer and the legacy stock Android Browser never added support.

What are the key elements of MathML?

MathML defines 32 core elements. The MDN reference groups them by purpose: math container, tokens, layout, scripts, tables, and semantics. Pages mix these tags inside a single math block to render any equation.

• math: The root element. Every MathML expression sits inside a math block, with display set through the display attribute.
• mi, mn, mo, ms, mtext: Token elements that wrap an identifier, number, operator, string literal, or text run.
• mrow: A grouping element that renders its children on the same row, similar to a span in HTML.
• mfrac: Renders a fraction with a numerator on top of a denominator separated by a horizontal bar.
• msqrt and mroot: Render a square root or an n-th root with a radical sign.
• msub, msup, msubsup: Render subscripts, superscripts, or both on a base expression.
• mover, munder, munderover: Place an accent or limit above, below, or both around a base expression.
• mtable, mtr, mtd: Render a math table for matrices and aligned equations, similar to HTML table markup.
• semantics, annotation, annotation-xml: Attach Content MathML, LaTeX, or other annotations to a Presentation MathML expression.

What are the use cases of MathML?

MathML is used wherever mathematical notation needs to render reliably and stay accessible. Schools, journals, e-readers, and documentation sites are the biggest adopters.

• EPUB and digital textbooks: EPUB 3 mandates MathML for math content, so every modern e-reader on iOS, Android, and Kindle ships a MathML renderer.
• Scientific journals and arXiv: Publishers convert LaTeX to MathML so equations render in HTML alongside the article body, with no image fallback.
• Online assessment platforms: Math testing tools like Wiris and Desmos embed MathML in question stems so the equations stay searchable, copyable, and screen-reader friendly.
• Accessibility for blind and low-vision readers: Screen readers like NVDA, JAWS, and VoiceOver speak MathML expressions in natural language, while plain images of equations stay silent.
• Wikipedia and encyclopedic sites: Wikipedia ships MathML alongside SVG and PNG fallbacks so articles render in every modern browser without external scripts.
• Library and framework documentation: SciPy, NumPy, and TensorFlow docs use MathML to render formulas in API references so developers can copy them straight into Python or LaTeX.

What are the known issues with MathML?

MathML works well in Firefox and Safari, but Chromium-based browsers and older mobile builds still trip up production sites. The biggest hits are stale Chrome installs, Internet Explorer, and font fallback gaps.

• Chrome 25 to 96 dropped MathML completely: After the experimental Chrome 24 build was removed for stability, Chrome had no MathML for nearly a decade. Sites that needed Chrome support during that window had to load MathJax.
• Chrome 97 to 108 hide MathML behind a flag: The MathMLCore flag at chrome://flags#enable-experimental-web-platform-features had to be on, otherwise math elements rendered as raw text.
• Internet Explorer never added it: IE 5.5 to 11 do not parse the math element. The MathPlayer plug-in used to fill the gap, but Microsoft removed it from active distribution.
• Font fallback varies across operating systems: MathML uses OpenType Math fonts, and Linux distributions without Latin Modern Math or STIX Two Math render some symbols as empty boxes. Ship a self-hosted Math font with a CSS @font-face block to avoid this.
• Content MathML is not rendered by browsers: Browsers only render Presentation MathML. A page that ships pure Content MathML inside apply tags shows nothing visible, so wrap it in a semantics block with a Presentation MathML annotation.
• Older Android Browser falls through to plain text: The stock Android Browser on Android 2.1 to 4.4.4 had no MathML renderer, so cleanup logic for legacy traffic still needs MathJax as a fallback.
• Screen reader voicing still varies: NVDA on Windows reads MathML well, but VoiceOver on iOS and macOS can stumble on long matrices and align environments. Test every equation with a real screen reader before shipping.

In my experience, the MathML font fallback is the trap that bites teams the most. A page reviewed on macOS looks perfect, but a Linux Firefox tester sees half the equation rendered as small empty rectangles, and the team spends an afternoon hunting before realizing the host operating system never installed Latin Modern Math.

Citations

All MathML version numbers and platform notes in this guide come from these primary sources:

• MDN Web Docs - MathML: developer.mozilla.org/en-US/docs/Web/MathML
• W3C - Mathematical Markup Language (MathML) Version 4.0: w3.org/TR/mathml4
• W3C - MathML Core specification: w3c.github.io/mathml-core
• W3C - What is MathML?: w3.org/Math/whatIsMathML.html
• Wikipedia - MathML: en.wikipedia.org/wiki/MathML
• Igalia - MathML in Chromium FAQ: mathml.igalia.com/faq
• Igalia - MathML in Web Browsers: mathml.igalia.com
• Chrome for Developers - MathML in Chromium: developer.chrome.com/blog/mathml
• WebKit blog: webkit.org/blog
• Mozilla Hacks - Firefox release notes: hacks.mozilla.org/category/firefox
• MathJax - MathML Support documentation: docs.mathjax.org/en/latest/input/mathml.html
• University of Washington AccessComputing - What is MathML?: washington.edu/accesscomputing/what-mathml