Also included is a python-markdown extension that translates
text enclosed between
$$ into MathML.
parse() generates a tree of elements:
>>> import asciimathml >>> asciimathml.parse('sqrt 2') <Element math at b76fb28c>
The tree can then be manipulated using the standard python library. For example we can generate its string representation:
>>> from xml.etree.ElementTree import tostring >>> tostring(asciimathml.parse('sqrt 2')) '<math><mstyle><msqrt><mn>2</mn></msqrt></mstyle></math>'
Or, if you want to add the attributes title and xmlns to the root node:
>>> tree = asciimathml.parse('sqrt 2') >>> tree.set('title', 'sqrt2') >>> tree.set('xmlns', 'http://www.w3.org/1998/Math/MathML') >>> tostring(tree) '<math title="sqrt2" xmlns="http://www.w3.org/1998/Math/MathML"><mstyle><msqrt><mn>2</mn></msqrt></mstyle></math>'
As you can see MathML is very verbose and is not intended to be written by hand.
And this is an example of ASCIIMathML embedded in markdown:
>>> import markdown >>> markdown.markdown('$$ sqrt 2 $$', ['asciimathml']) u'<p>\n<math xmlns="http://www.w3.org/1998/Math/MathML"><mstyle><msqrt><mn>2</mn></msqrt></mstyle></math>\n</p>'
Dependencies and installation
Tested with python 2.7. The core module,
asciimathml has no dependencies.
The markdown extension
mdx_asciimathml requires at least markdown 2.0.
setup.py is provided (as usual it's enough to execute
setup.py install to perform the installation). You can also manually copy the
asciimathml.py and (optionally)
mdx_asciimathml.py somewhere in
The current status of support for MathML by web browsers is disheartening.
As far as I know only firefox and opera, among the major browsers, can properly render MathML (webkit support is on the way, you can follow progress made closing the tickets of this master bug).
But please note that MathML is displayed correctly only when embedded in a XHTML or in HTML5 document.
XHTML must be served with content type 'application/xhtml+xml' (it's not enough for the document to be valid XHTML). As you know this will prevent IE (up to IE8, I haven't tested with IE9) from displaying the page at all.
HTML5 on the other hand is backwards compatible, but is not enabled by default on the current version of firefox (3.6). The user must enable it explicitly by setting to true 'html5' in about:config.