Python-Markdown

Markdown是一个轻文本标记语言，它允许你在写的时候使用简单文本格式，然后转换为XHTML（HTML）。Python-markdown2是完全用Python实现的Markdown，与用Perl实现的 Markdown.pl非常接近，同时增加了一些扩展，包括语法高亮等。

示例：

python markdown2.py foo.md > foo.html

github主页：

Python-Markdown是John Gruber的Markdown语法的python实现。但是与一般Markdown还是有些许差别。这些差别包括：

* Python-Markdown默认忽略掉单词中间的加重标识(middle-word emphasis)。如some_long_filename.txt不会被转译成somelongfilename.txt
* Markdown语法规则中指出如果一个列表组件包含多个段落，那么后面的段落必须空出4个空格或者一个tab。与其他语法解释器不同，Python-Markdown严格遵守这条规定，并且所有在列表中的块一级元素都如此规定。
* 当列表的一行遇到其他列表标识（如星号，数字等），官方规则没有指明是否需要另起一行。为了一致性，Python-Markdown也不做修改。但是Sane List 这个扩展模块提供了更友好的解决方式。

另外，Python-Markdown还提供的弹性的扩展机制。允许使用者在不修改项目源代码的情况下，对自己想要扩展的语法进行扩展开发。官方已经提供的扩展模块如下：

Extension    “Name”
Extra    extra
Abbreviations    abbr
Attribute Lists    attr_list
Definition Lists  def_list
Fenced Code Blocks  fenced_code
Footnotes    footnotes
Tables    tables
Smart Strong    smart_strong
Admonition    admonition
CodeHilite    codehilite
HeaderId    headerid
Meta-Data    meta
New Line to Break    nl2br
Sane Lists    sane_lists
SmartyPants    smarty
Table of Contents    toc
WikiLinks    wikilinks

除了官方的扩展，还有无数第三方扩展，这些扩展可以在找到。

参考：http://my.oschina.net/sundiontheway/blog/285003