Pure Python library for LaTeX to MathML conversion

3.79.0 · active · verified Fri Apr 10

latex2mathml is a pure Python library for converting LaTeX math expressions to MathML. It supports a wide range of LaTeX commands and environments. The current version is 3.79.0 and it maintains an active release cadence, with recent updates.

Warnings

breaking The primary `convert` function moved from the top-level `latex2mathml` module to `latex2mathml.converter`. Direct import `from latex2mathml import convert` will fail.
Fix: Update imports to `from latex2mathml.converter import convert`.
gotcha The library has limitations in supported LaTeX commands, particularly for complex structures. Examples of often unsupported features include newlines (`\\`) outside of matrix/align environments, alignment characters (`&`) outside matrix/align environments, and complicated sub/superscripts (`<mmultiscripts>`).
Fix: Simplify LaTeX input where possible or consult the project's documentation/examples for supported syntax if encountering conversion issues.
gotcha The `\begin{align}` environment is experimentally supported and may produce non-recommended or poorly formatted MathML output, as it is internally implemented using a matrix environment.
Fix: Review the MathML output carefully for `align` environments and consider alternative LaTeX structures if rendering issues occur.
gotcha MathML rendering is highly dependent on the browser and its installed fonts. Chromium-based browsers, in particular, may display MathML incorrectly without specific CSS font configurations (e.g., using STIX fonts). This is a browser limitation, not a library issue.
Fix: Provide appropriate CSS to specify MathML-compatible fonts (e.g., `STIX-Two-Math`) for web display if targeting browsers with known rendering issues.

Install

pip install latex2mathml Install latest version

Imports

convert
```
from latex2mathml.converter import convert
```
The direct import from the top-level 'latex2mathml' package for the 'convert' function was used in older versions (e.g., 1.x) but is now found within the 'converter' submodule.

Quickstart

Convert a simple LaTeX math string to MathML.

from latex2mathml.converter import convert

latex_input = r'E = mc^2'
mathml_output = convert(latex_input)
print(mathml_output)

view raw JSON →