Admonitions! with Python-Markdown 2.3 release.
waylan at gmail.com
Fri Mar 15 22:34:56 EDT 2013
Last night I released version 2.3 of Python Markdown (see the release
notes  for all the details). In addition to various other
improvements, a new **experimental** extension was included that added
a syntax for generating rST-style admonitions . For a summary of
the syntax, see the documentation . A broader sample of the output
can be seen on this page . The source text can be found by swapping
the ".html" file extension for ".txt" . You can test it here 
(be sure to enable the extension).
Experimental code has been released into the wild!
As noted, this is considered experimental. It is subject to change. I
realize that I could have overlooked something obvious and am not yet
completely committed to the syntax. Interestingly, I had drafted a
proposal some time ago (maybe a year ago) but never finished it.
Independently, "slig"  proposed an almost identical proposal .
Seeing how close our proposals were, we tweaked the syntax (meeting in
the middle) and "slig" wrote all the code.
So what does everyone think? I know the examples in the
Python-Markdown docs aren't the best. We're using the Python default
documentation theme (CSS) which makes the title inline with the first
paragraph - which is a little weird. What's great about it though, is
that no changes needed to be made to the CSS for it to work. Same
applies to any Sphinx themes .
\X/ /-\ `/ |_ /-\ |\|
More information about the Markdown-Discuss