Summary

A compilation of various Python-Markdown extensions that (mostly) imitates PHP Markdown Extra.

The supported extensions include:

• Fenced_Code_Blocks
• Footnotes
• HeaderId
• SimpleTables
• Abbreviations

As no-one has yet written a Definition List extension for Python-Markdown, definition lists are not yet supported by Extra.

Get the Code

The code is currently available in the Python-Markdown Git repository and will likely be included in a future release.

Dependencies

• Python 2.3+
• Markdown 2.0+

Usage

From the Python interpreter:

>>> import markdown
>>> html = markdown.markdown(text, ['extra'])

Note that each of the individual extensions still need to be available on your PYTHONPATH. This extension simply wraps them all up as a convenience so that only one extension needs to be listed when initiating Markdown. See the documentation for each individual extension for specifics about that extension.

In the event that one or more of the supported extensions are not available for import, Markdown will simply continue without that extension. If you would like to be notified of such failures, you may set Python-Markdown's logger level to "WARN".

There may be additional extensions that are distributed with Python-Markdown that are not included here in Extra. Those extensions are not part of PHP Markdown Extra, and therefore, not part of Python-Markdown Extra. If you really would like Extra to include additional extensions, we suggest creating your own clone of Extra under a different name (see Writing Extensions). You could also edit the extensions global variable defined in the source, but be aware that such changes may be lost when you upgrade to any future version of Python-Markdown.