The current version of python-markdown implements all Markdown syntax features and fully passes Markdown Test Suite 1.0, despite having a few known issues (see below).

Known Issues

Nested Markup

Not all Markdown markup can be nested. In particular, you cannot put images in links, e.g.:

[![my logo][logo]][root]
[logo]: http://www.freewisdom.org/etc/markdown-in-python.png
[root]: http://www.freewisdom.org/projects/python-markdown/

Note, however, that the desired markup can be generated with a bit of HTML - and is more readable.

[<img src="http://www.freewisdom.org/etc/markdown-in-python.png"/>][root]
[root]: http://www.freewisdom.org/projects/python-markdow

Extra Features

Bi-directional Text

The version currently in subversion adds support for bi-directional text.

Footnotes

Python Markdown supports footnotes as proposed in this thread.

Attributes

It also supports attributes (see this thread).

Middle-World Emphasis

Python Markdown defaults to ignoring middle-word emphasis. In other words, MY_CONFIG_VALUE is not going to be converted into MYCONFIGVALUE. This it can be switched off. (See this thread for discussion.)

Bug Reports

If you find something missing, submit a bug report or send me an email (qaramazov-at-gmail.com). Better yet, send me a patch.