MathML the “HTML for math”
The web (HTML5), ebook (epub3) and publishing (XML) standard for mathematical equations is MathML. Just like HTML, MathML can be highly verbose, so manual input is usually done using other tools. In particular, there are several serial math input formats (see below).
Many markdown parser tolerate HTML fragments, so MathML fragment can be used when manual input languages are not sufficient.
Serialized math syntax
Markdown is usually combined with the most established ones: LaTeX-like syntax (preferrably compatible with MathJax) and ASCIImath syntax.
The most frequently used syntax can be described as “LaTeX-like”. Using LaTeX syntax for math notation has many advantages, the biggest is the number of tools available for LaTeX. This makes it the most versatile syntax for conversion into other formats (MS Word via MathML, PDF via LaTeX, HTML using MathJax).
Another option is jqmath, which is designed as a serialization of MathML.
In the conversion process from markdown to other formats, the following options are most frequent:
- nothing special.
- Depending on the markdown converter this can work well or be disastrous. Especially “classic” mardkown parsers will interpret every backslash as an escape character and render LaTeX syntax useless.
- leaving the input untouched
- Some parsers like pandoc have added extensions which identify math delimiters (usually
$) and treat the content between delimiters as verbatim text – leaving the correct rendering to other tools such as MathJax.
- converting equations to MathML
- converting equations to images
Next: Extending Markdown
Markdown is a lightweight format that does not offer built-in facilities for extension. Instead it is recommended to combine external templating tools to adapt the syntax to particular use cases, where necessary. To avoid an unnecessary inflation in the number of markdown flavors out there, it is recommended that language extensions are used sparingly.