# MathML

Developed by World Wide Web Consortium Markup language XML W3C MathML

Mathematical Markup Language (MathML) is a mathematical markup language, an application of XML for describing mathematical notations and capturing both its structure and content. It aims at integrating mathematical formulae into World Wide Web pages and other documents. It is part of HTML5 and an ISO standard ISO/IEC DIS 40314 since 2015.

## History

MathML 1 was released as a W3C recommendation in April 1998 as the first XML language to be recommended by the W3C. Version 1.01 of the format was released in July 1999 and version 2.0 appeared in February 2001.

In October 2003, the second edition of MathML Version 2.0 was published as the final release by the W3C math working group.

MathML was originally designed before the finalization of XML namespaces. However it was assigned a namespace immediately after the Namespace Recommendation was completed, and for XML use, the elements should be in the namespace with namespace URI http://www.w3.org/1998/Math/MathML. When MathML is used in HTML (as opposed to XML) this namespace is automatically inferred by the HTML parser and need not be specified in the document.

### MathML version 3

Version 3 of the MathML specification was released as a W3C recommendation on 20 October 2010. A recommendation of A MathML for CSS Profile was later released on 7 June 2011;[1] this is a subset of MathML suitable for CSS formatting. Another subset, Strict Content MathML, provides a subset of content MathML with a uniform structure and is designed to be compatible with OpenMath. Other content elements are defined in terms of a transformation to the strict subset. New content elements include <bind> which associates bound variables (<bvar>) to expressions, for example a summation index. The new <share> element allows structure sharing.[2]

The development of MathML 3.0 went through a number of stages. In June 2006 the W3C rechartered the MathML Working Group to produce a MathML 3 Recommendation until February 2008 and in November 2008 extended the charter to April 2010. A sixth Working Draft of the MathML 3 revision was published in June 2009. On 10 August 2010 version 3 graduated to become a "Proposed Recommendation" rather than a draft.[2]

The Second Edition of MathML 3.0 was published as a W3C Recommendation on April 10, 2014.[3] The specification was approved as an ISO/IEC international standard 40314:2015 on June 23, 2015.[4]

## Presentation and semantics

MathML deals not only with the presentation but also the meaning of formula components (the latter part of MathML is known as “Content MathML”). Because the meaning of the equation is preserved separate from the presentation, how the content is communicated can be left up to the user. For example, web pages with MathML embedded in them can be viewed as normal web pages with many browsers, but visually impaired users can also have the same MathML read to them through the use of screen readers (e.g. using the MathPlayer plugin for Internet Explorer, Opera 9.50 build 9656+ or the Fire Vox extension for Firefox).

### Presentation MathML

Presentation MathML focuses on the display of an equation, and has about 30 elements. The elements' names all begin with m. A Presentation MathML expression is built up out of tokens that are combined using higher-level elements, which control their layout (there are also about 50 attributes, which mainly control fine details).

Token elements generally only contain characters (not other elements). They include:

• <mi>x</mi> – identifiers;
• <mo>+</mo> – operators;
• <mn>2</mn> – numbers.
• <mtext>non zero</mtext> – text.

Note however that these token elements may be used as extension points, allowing markup in host languages. MathML in HTML5 allows most inline HTML markup in mtext, and

• <mtext><b>non</b> zero</mtext>

is conforming, with the HTML markup being used within the MathML to mark up the embedded text (making the first word bold in this example).

These are combined using layout elements, that generally contain only elements. They include:

• <mrow> – a horizontal row of items;
• <msup>, <munderover>, and others – superscripts, limits over and under operators like sums, etc.;
• <mfrac> – fractions;
• <msqrt> and <mroot> – roots;
• <mfenced> - surrounding content with fences, such as parentheses.

As usual in HTML and XML, many entities are available for specifying special symbols by name, such as &pi; and &RightArrow;. An interesting feature of MathML is that entities also exist to express normally-invisible operators, such as &InvisibleTimes; for implicit multiplication. They are:

U+2061 FUNCTION APPLICATION; U+2062 INVISIBLE TIMES; U+2063 INVISIBLE SEPARATOR; and U+2064 INVISIBLE PLUS. The full specification of MathML entities [5] is closely coordinated with the corresponding specifications for use with HTML and XML [6] in general.

Thus, the expression ${\displaystyle ax^{2}+bx+c}$ requires two layout elements: one to create the overall horizontal row and one for the superscripted exponent. Including only the layout elements and the (not yet marked up) bare tokens, the structure looks like this:

    <mrow>
a &InvisibleTimes; <msup>x 2</msup>
+ b &InvisibleTimes; x
+ c
</mrow>


However, the individual tokens also have to be identified as identifiers (mi), operators (mo), or numbers (mn). Adding the token markup, the full form ends up as:

    <mrow>
<mi>a</mi> <mo>&InvisibleTimes;</mo> <msup><mi>x</mi><mn>2</mn></msup>
<mo>+</mo><mi>b</mi><mo>&InvisibleTimes;</mo><mi>x</mi>
<mo>+</mo><mi>c</mi>
</mrow>


A valid MathML document typically consists of the XML declaration, DOCTYPE declaration, and document element. The document body then contains MathML expressions which appear in $elements as needed in the document. Often, MathML will be embedded in more general documents, such as HTML, DocBook, or other XML schemas. A complete document that consists of just the MathML example above, is shown here:  <?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE math PUBLIC "-//W3C//DTD MathML 2.0//EN" "http://www.w3.org/Math/DTD/mathml2/mathml2.dtd"> <math xmlns="http://www.w3.org/1998/Math/MathML"> <mrow> <mi>a</mi> <mo>&InvisibleTimes;</mo> <msup> <mi>x</mi> <mn>2</mn> </msup> <mo>+</mo> <mi>b</mi> <mo>&InvisibleTimes; </mo> <mi>x</mi> <mo>+</mo> <mi>c</mi> </mrow>$


### Content MathML

Content MathML focuses on the semantics, or meaning, of the expression rather than its layout. Central to Content MathML is the <apply> element that represents function application. The function being applied is the first child element under <apply>, and its operands or parameters are the remaining child elements. Content MathML uses only a few attributes.

Tokens such as identifiers and numbers are individually marked up, much as for Presentation MathML, but with elements such as ci and cn. Rather than being merely another type of token, operators are represented by specific elements, whose mathematical semantics are known to MathML: times, power, etc. There are over a hundred different elements for different functions and operators[7].

For example, <apply><sin/><ci>x</ci></apply> represents ${\displaystyle \sin(x)}$ and <apply><plus/><ci>x</ci><cn>5</cn></apply> represents ${\displaystyle x+5}$. The elements representing operators and functions are empty elements, because their operands are the other elements under the containing <apply>.

The expression ${\displaystyle ax^{2}+bx+c}$ could be represented as

$<apply> <plus/> <apply> <times/> <ci>a</ci> <apply> <power/> <ci>x</ci> <cn>2</cn> </apply> </apply> <apply> <times/> <ci>b</ci> <ci>x</ci> </apply> <ci>c</ci> </apply>$


Content MathML is nearly isomorphic to expressions in a functional language such as Scheme. <apply>...</apply> amounts to Scheme's (...), and the many operator and function elements amount to Scheme functions. With this trivial literal transformation, plus un-tagging the individual tokens, the example above becomes:

  (plus
(times a (power x 2))
(times b x)
c)


This reflects the long-known close relationship between XML element structures, and LISP or Scheme S-expressions.[8][9]

#### Wikidata annotation in Content MathML

According to the OM Society[10], OpenMath Content Dictionaries can be employed as collections of symbols and identifiers with declarations of their semantics - names, descriptions and rules. As proposed in[11], the semantic knowledge-base Wikidata[12] can be used as OpenMath Content Dictionary to link semantic elements of a mathematical formula to unique and language-independent Wikidata items.

## Example and comparison to other formats

${\displaystyle x={\frac {-b\pm {\sqrt {b^{2}-4ac}}}{2a}}}$

would be marked up using LaTeX syntax like this:

x=\frac{-b \pm \sqrt{b^2 - 4ac}}{2a}


in troff/eqn like this:

x={-b +- sqrt{b sup 2 – 4ac}} over 2a


in Apache OpenOffice Math and LibreOffice Math like this (all three are valid):

x={-b plusminus sqrt {b^2 – 4 ac}} over {2 a}
x={-b +- sqrt {b^2 – 4ac}} over {2a}
x={-b ± sqrt {b^2 – 4ac}} over {2a}


in AsciiMath like this:

x=(-b +- sqrt(b^2 - 4ac))/(2a)


The above equation could be represented in Presentation MathML as an expression tree made up from layout elements like mfrac or msqrt elements:

<math mode="display" xmlns="http://www.w3.org/1998/Math/MathML">
<semantics>
<mrow>
<mi>x</mi>
<mo>=</mo>
<mfrac>
<mrow>
<mo form="prefix">&#x2212;<!-- − --></mo>
<mi>b</mi>
<mo>&#x00B1;<!-- &PlusMinus; --></mo>
<msqrt>
<msup>
<mi>b</mi>
<mn>2</mn>
</msup>
<mo>&#x2212;<!-- − --></mo>
<mn>4</mn>
<mo>&#x2062;<!-- &InvisibleTimes; --></mo>
<mi>a</mi>
<mo>&#x2062;<!-- &InvisibleTimes; --></mo>
<mi>c</mi>
</msqrt>
</mrow>
<mrow>
<mn>2</mn>
<mo>&#x2062;<!-- &InvisibleTimes; --></mo>
<mi>a</mi>
</mrow>
</mfrac>
</mrow>
<annotation encoding="TeX">
x=\frac{-b\pm\sqrt{b^2-4ac}}{2a}
</annotation>
<annotation encoding="StarMath 5.0">
x={-b plusminus sqrt {b^2 - 4 ac}} over {2 a}
</annotation>
</semantics>
[/itex]


This example uses the <annotation> element, which can be used to embed a semantic annotation in non-XML format, for example to store the formula in the format used by an equation editor such as StarMath or the markup using LaTeX syntax.

Although less compact than TeX, the XML structuring promises to make it widely usable and allows for instant display in applications such as Web browsers and facilitates an interpretation of its meaning in mathematical software products. MathML is not intended to be written or edited directly by humans.[13]

## Embedding MathML in HTML/XHTML files

MathML, being XML, can be embedded inside other XML files such as XHTML files using XML namespaces. Recent browsers such as Firefox 3+ and Opera 9.6+ (support incomplete) can display Presentation MathML embedded in XHTML.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html  PUBLIC "-//W3C//DTD XHTML 1.1 plus MathML 2.0//EN"
"http://www.w3.org/Math/DTD/mathml2/xhtml-math11-f.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
<title>Example of MathML embedded in an XHTML file</title>
<meta name="description" content="Example of MathML embedded in an XHTML file"/>
<body>
<h1>Example of MathML embedded in an XHTML file</h1>
<p>
The area of a circle is
<math xmlns="http://www.w3.org/1998/Math/MathML">
<mi>&#x03C0;<!-- π --></mi>
<mo>&#x2062;<!-- &InvisibleTimes; --></mo>
<msup>
<mi>r</mi>
<mn>2</mn>
</msup>
[/itex].
</p>
</body>
</html>

A rendering of the formula for a circle in MathML+XHTML using Firefox 22 on Mac OS X

Inline MathML is also supported in HTML5 files in the current versions of WebKit (Safari and JavaFX/WebView ), Gecko (Firefox). There is no need to specify namespaces like in the XHTML.

<!DOCTYPE html>
<html lang="en">
<meta charset="utf-8">
<title>Example of MathML embedded in an HTML5 file</title>
<body>
<h1>Example of MathML embedded in an HTML5 file</h1>
<p>
The area of a circle is
<math>
<mi>&pi;</mi>
<mo>&InvisibleTimes;</mo>
<msup>
<mi>r</mi>
<mn>2</mn>
</msup>
</math>.
</p>
</body>
</html>


## Browser support

Of the major web browsers, Gecko-based browsers (e.g., Firefox and Camino) have the most complete native support for MathML.[14][15]

While the WebKit layout engine has a development version of MathML,[16] this feature is only available in version 5.1 and higher of Safari,[17] Chrome 24[18][19] but not in later versions of Chrome.[20] Google removed support of MathML claiming architectural security issues and low usage do not justify their engineering time.[21] As of October 2013, the WebKit/Safari implementation has numerous bugs.[22]

JavaFX/WebView. Also based on WebKit, the JavaFX embedded web browser supports MathML starting with JavaFX 8 Update 192 and JavaFX 11 versions. Support is broken, in JavaFX 8 previous versions, JavaFX 9 and JavaFX 10.

Opera, between version 9.5 and 12, supports MathML for CSS profile,[23][24] but is unable to position diacritical marks properly.[25] Prior to version 9.5 it required User JavaScript or custom stylesheets to emulate MathML support.[26] Starting with Opera 14, Opera drops support for MathML by switching to the Chromium 25 engine.[27]

Internet Explorer does not support MathML natively. Support for IE6 through IE9 can be added by installing the MathPlayer plugin.[28] IE10 has some crashing bugs with MathPlayer and Microsoft decided to completely disable in IE11 the binary plug-in interface that MathPlayer needs.[29] MathPlayer has a license that may limit its use or distribution in commercial webpages and software. Using or distributing the MathPlayer plugin to display HTML content via the WebBrowser control in commercial software may also be forbidden by this license.

The KHTML-based Konqueror currently does not provide support for MathML.[30]

The quality of rendering of MathML in a browser depends on the installed fonts. The STIX Fonts project have released a comprehensive set of mathematical fonts under an open license. The Cambria Math font supplied with Microsoft Windows had a slightly more limited support.[31]

According to a member of the MathJax team, none of the major browser makers paid any of their developers for any MathML-rendering work; whatever support exists is overwhelmingly the result of unpaid volunteer time/work.[32]

In 2015 the MathML Association was founded to support the adoption of the MathML standard.[33]

## Other standards

Another standard called OpenMath that has been designed (largely by the same people who devised Content MathML) more specifically for storing formulae semantically can also be used to complement MathML. OpenMath data can be embedded in MathML using the <annotation-xml encoding="OpenMath"> element. OpenMath content dictionaries can be used to define the meaning of <csymbol> elements. The following would define P1(x) to be the first Legendre polynomial

<apply>
<csymbol encoding="OpenMath" definitionURL="http://www.openmath.org/cd/contrib/cd/orthpoly1.xhtml#legendreP">
<msub><mi>P</mi><mn>1</mn></msub>
</csymbol>
<ci>x</ci>
</apply>


The OMDoc format has been created for markup of larger mathematical structures than formulae, from statements like definitions, theorems, proofs, or example, to theories and text books. Formulae in OMDoc documents can either be written in Content MathML or in OpenMath; for presentation, they are converted to Presentation MathML.

The ISO/IEC standard Office Open XML (OOXML) defines a different XML math syntax, derived from Microsoft Office products. However, it is partially compatible[34] through relatively simple XSL Transformations.

## References

1. ^ "A MathML for CSS Profile". W3C. 7 June 2011. Retrieved 25 July 2013.
2. ^ a b Mathematical Markup Language Version 3.0 W3C Recommendation. W3.org. Retrieved on 9 May 2012.
3. ^ MathML Version 3.0 2nd Edition. W3.org. Retrieved on 8 July 2014.
4. ^ W3C MathML 3.0 Approved as ISO/IEC International Standard. W3.org. Retrieved on July 12, 2015.
5. ^ http://www.w3.org/TR/MathML3/chapter7.html
6. ^ http://www.w3.org/TR/xml-entity-names/
7. ^ http://www.w3.org/TR/MathML3/chapter4.html#contm.opel
8. ^ Steven DeRose. The SGML FAQ Book: Understanding the Relationship of SGML and XML, Kluwer Academic Publishers, 1997. ISBN 978-0-7923-9943-8.
9. ^ Canonical S-expressions#cite note-0
10. ^ http://www.openmath.org. Missing or empty |title= (help)
11. ^ Moritz Schubotz; Philipp Scharpf; Bela Gipp. (2018). "Representing Mathematical Formulae in Content MathML using Wikidata" (PDF). Birndl@sigir.
12. ^ https://www.wikidata.org. Missing or empty |title= (help)
13. ^ Buswell, Steven; Devitt, Stan; Diaz, Angel; et al. (7 July 1999). "Mathematical Markup Language (MathML) 1.01 Specification (Abstract)". Retrieved 26 September 2006. While MathML is human-readable it is anticipated that, in all but the simplest cases, authors will use equation editors, conversion programs, and other specialized software tools to generate MathML.
14. ^ Wang, Frédéric, Mozilla MathML Status, Mozilla
15. ^ Sidje, Roger B., Authoring MathML for Mozilla, Mozilla
16. ^ Bug 3251 – Implement MathML (master bug), WebKit . . . (However, "see also") https://trac.webkit.org/wiki/MathML%20Status
17. ^
18. ^ MathML Support Coming To Chrome, BrowserFame, retrieved 16 October 2012
19. ^ Stable Chrome 24 supports MathML and closes security holes, The H Online, retrieved 11 January 2013
20. ^ Stable Channel Update, retrieved 7 April 2013
21. ^ "Google subtracts MathML from Chrome, and anger multiplies". CNET. Retrieved 22 November 2014.
22. ^ Frédéric Wang. "Funding MathML Developments in Gecko and WebKit - Blog de Frédéric". maths-informatique-jeux.com. Retrieved 22 November 2014.
23. ^ McCathieNevile, Charles (27 September 2007), Can Kestrels do Math? MathML support in Opera Kestrel, Opera
24. ^ Olsen, Tommy A. (16 November 2007), Even more work, Opera, archived from the original on 18 November 2007
25. ^ MathML – The Opera MathML blog. My.opera.com (1 November 2007). Retrieved on 9 May 2012.
26. ^ UserJS for MathML 2.0. My.opera.com. Retrieved on 9 May 2012.
27. ^ Opera 14 beta for Android is out, archived from the original on 8 March 2013
28. ^
29. ^ "Microsoft cripples the display of math in IE10 & 11". dessci.com. Retrieved 22 November 2014.
30. ^
31. ^ Vismor, Timothy, Viewing Mathematics on the Internet, retrieved 13 April 2011
32. ^ Peter Krautzberger. "MathML forges on". oreilly.com. Retrieved 22 November 2014.
33. ^ Deyan Ginev; Michael Kohlhase; Moritz Schubotz; Raniere Silva; Frédéric Wang, Mondial Association for Tools Handling MathML, retrieved 20 June 2016
34. ^ David Carlisle (9 May 2007), XHTML and MathML from Office 2007, David Carlisle, retrieved 20 September 2007