MWParserFromHell v0.7 Documentation

mwparserfromhell (the MediaWiki Parser from Hell) is a Python package that provides an easy-to-use and outrageously powerful parser for MediaWiki wikicode. It supports Python 3.8+.

Developed by Earwig with contributions from Σ, Legoktm, and others. Development occurs on GitHub.


The easiest way to install the parser is through the Python Package Index; you can install the latest release with pip install mwparserfromhell (get pip). Make sure your pip is up-to-date first, especially on Windows.

Alternatively, get the latest development version:

git clone
cd mwparserfromhell
python install

The comprehensive unit testing suite requires pytest (pip install pytest) and can be run with python -m pytest.


Indices and tables