Python-Markdown 模塊簡介

Python-Markdown是John Gruber的Markdown語法的python實現。可是與通常Markdown仍是有些許差異。這些差異包括：

* Python-Markdown默認忽略掉單詞中間的加劇標識(middle-word emphasis)。如some_long_filename.txt不會被轉譯成some<em>long</em>filename.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

除了官方的擴展，還有無數第三方擴展，這些擴展能夠在https://github.com/waylan/Python-Markdown/wiki/Third-Party-Extensions找到。