== Overview ==

Fonts with appropriate Unicode coverage and Open Font Format features are required for good math rendering. Maintainers of WebKit ports and operating systems should ensure that such fonts are available to get more reliable results on MathML tests and to maximize user experience. WebKit users encountering troubles with the rendering of MathML are encouraged to check that such a font is installed on their system. They are also invited to configure the default math font to match their preference.

== Recommended Math Fonts ==

Here is a list of known math fonts that can be used to render MathML formulas in WebKit:

* [http://www.ctan.org/tex-archive/fonts/Asana-Math/ Asana Math]
* [http://www.microsoft.com/typography/fonts/family.aspx?FID=360 Cambria Math]
* [http://www.gust.org.pl/projects/e-foundry/lm-math Latin Modern Math]
* [https://github.com/khaledhosny/libertinus Libertinus Math]
* [http://tug.org/store/lucida/opentype.html Lucida Bright Math]
* [http://www.typoma.com/en/fonts.html Minion Math]
* [http://sourceforge.net/projects/stixfonts/files/Current%20Release/STIXv1.1.1-word.zip/download STIX Math]
* [http://www.gust.org.pl/projects/e-foundry/tg-math/download/index_html#Bonum_Math TeX Gyre Bonum Math]
* [http://www.gust.org.pl/projects/e-foundry/tg-math/download/index_html#Pagella_Math TeX Gyre Pagella Math]
* [http://www.gust.org.pl/projects/e-foundry/tg-math/download/index_html#Schola_Math TeX Gyre Schola Math]
* [http://www.gust.org.pl/projects/e-foundry/tg-math/download/index_html#Termes_Math TeX Gyre Termes Math]
* [https://github.com/khaledhosny/xits-math/releases XITS Math]

Latin Modern Math is recommended for users who are familiar with [https://en.wikipedia.org/wiki/Computer_Modern TeX's Computer Modern style]. The STIX family provides the best unicode coverage but it has many bugs that will only be fixed in version 2. These two fonts form the recommended minimal set to consider for maintainers and the default option to try for users.

== Customizing Math Font ==

The default font-family on the `<math>` tag is not inherited but set to a list of known math fonts. Authors or readers of MathML equations can easily customize it by adding the following CSS rule to the author/user style sheet:

{{{
  math {
     font-family: "My Fancy Math Font";
  }
}}}

For best rendering, it is recommended to use text font and math font that have consistent style. For example, authors can use the following stylesheet to display their page with the "Latin Modern" style:

{{{
  body {
     font-family: "Latin Modern Roman";
  }
  math {
     font-family: "Latin Modern Math";
  }
}}}

For more information, this [https://github.com/fred-wang/MathFonts/  page with Web fonts, sample CSS style sheets and online demos].

== Unicode Coverage ==

In order to display various scientific and technical symbols, math fonts should cover the largest possible subset of [https://www.w3.org/TR/xml-entity-names/#blocks Unicode Character Ranges for Scientific Documents] and more specifically:

* [https://www.w3.org/TR/xml-entity-names/#alphabets Mathematical Alphanumeric Characters]

* [https://www.w3.org/TR/MathML3/appendixc.html#oper-dict.entries-table Operators from the MathML dictionary].

Mathematical Alphanumeric Characters are required to display variables with their default mathematical italic style and to support the `mathvariant` attribute. However, the former is currently done with CSS ([https://bugs.webkit.org/show_bug.cgi?id=155018 bug 155018]) and the latter is not implemented yet ([https://bugs.webkit.org/show_bug.cgi?id=108778 bug 108778]).

== Open Font Format features ==

Development is in progress to [http://www.mathml-association.org/MathMLinHTML5/ make our MathML support rely on TeX rules and OpenType features]. Below are some features that should be provided by math fonts and implemented in WebKit:

=== MathConstants table ===

=== MathGlyphInfo table ===

=== MathVariants table ===

=== Tags ===

Nothing has been implemented yet. The following tags should be considered:
`math`, `ssty`, `flac`, `dtls` and `rtlm`.