用 markdown 包進行轉(zhuǎn)換。
pip install Markdown
參考文檔：https://python-markdown.github.io/
基本用法
使用 markdown.markdown() 函數(shù)將 markdown 字符串轉(zhuǎn)換為 html 字符串俺夕。
import codecs, markdown
# 讀取 markdown 文本
input_file = codecs.open("some_file.md", mode="r", encoding="utf-8")
text = input_file.read()
# 轉(zhuǎn)為 html 文本
html = markdown.markdown(text)
# 保存為文件
output_file = codecs.open("some_file.html", mode="w", encoding="utf-8")
output_file.write(html)
注意：markdown包的輸入和輸出都只采用 utf-8 編碼题造。
使用擴展
markdown.markdown() 函數(shù)的參數(shù) extensions 指定擴展列表悼瓮。
擴展列表的每一項為擴展類實例或擴展名（無參數(shù)擴展）：
ext1_instance = ExtClass1()
ext2_str = "ExtClass2()"
extensions=[ext1_instance, ext2_str]
在構(gòu)造擴展實例時可對擴展進行配置：
from markdown.extensions import Extension
class MyExtClass(Extension):
# define your extension here...
def __init__(self, option):
# ...
markdown.markdown(text, extensions=[MyExtClass(option='value')])
其他參數(shù)和用法
markdown.markdown 函數(shù)還可設置以下參數(shù)：
-
output_format: 參數(shù)默認值為xhtml，可改為html5告喊。 -
tab_length: 源文件中tab字符代表的空格數(shù)闪檬，默認值為4。
每次調(diào)用 markdown.markdwon 函數(shù)時氛悬，都創(chuàng)建了一個 markdown.Markdown 類實例则剃。當處理大量文件時，為提高效率如捅，可手動創(chuàng)建一個 Markdown 類實例棍现，重復調(diào)用它的 convert() 和 reset() 函數(shù)。
md = markdown.Markdown()
html1 = md.convert(text1)
md.reset()
html2 = md.convert(text2)
html3 = md.reset().convert(text3)
Markdown 類的構(gòu)造函數(shù)參數(shù)與 markdown 函數(shù)相同镜遣。
擴展說明
1. abbr擴展
from markdown.extensions.abbr import AbbrExtension
語法例子：
The HTML specification
is maintained by the W3C.
*[HTML]: Hyper Text Markup Language
*[W3C]: World Wide Web Consortium
轉(zhuǎn)換為：
<p>The <abbr title="Hyper Text Markup Language">HTML</abbr> specification
is maintained by the <abbr title="World Wide Web Consortium">W3C</abbr>.</p>
2. attr_list擴展
在 HTML 元素上指定屬性名和屬性值己肮。
from markdown.extensions.abbr import AbbrExtension
基本語法：
{: #someid .someclass somekey='some value' }
例子1：
{: #id1 .class1 id=id2 class="class2 class3" .class4 }
轉(zhuǎn)為
id="id2" class="class2 class3 class4"
注：.id1 被后面的 id=id2 覆蓋，.class1 被后面的 class=class2 class3 覆蓋悲关。
例子2：段落屬性
This is a paragraph.
{: #an_id .a_class }
轉(zhuǎn)為
<p id="an_id" class="a_class">This is a paragraph.</p>
例子3：標題屬性
A setext style header {: #setext}
=================================
### A hash style header ### {: #hash }
轉(zhuǎn)為
<h1 id="setext">A setext style header</h1>
<h3 id="hash">A hash style header</h3>
例子4：鏈接屬性
[link](http://example.com){: class="foo bar" title="Some title!" }
轉(zhuǎn)為
<p><a class="foo bar" title="Some title!">link</a></p>
3. def_list 擴展
from markdown.extensions.def_list import DefListExtension
語法：
Apple
: Pomaceous fruit of plants of the genus Malus in
the family Rosaceae.
Orange
: The fruit of an evergreen tree of the genus Citrus
轉(zhuǎn)為
<dl>
<dt>Apple</dt>
<dd>Pomaceous fruit of plants of the genus Malus in
the family Rosaceae.</dd>
<dt>Orange</dt>
<dd>The fruit of an evergreen tree of the genus Citrus.</dd>
</dl>
4. fenced_code 擴展
from markdown.extensions.fenced_code import FencedCodeExtension
語法例子：
```python
# python code
```
轉(zhuǎn)為
<pre><code class="python"># python code
</code></pre>
注意：代碼塊只作為文檔的根元素谎僻，不能嵌入列表或引用等塊元素中。
5. footnotes 擴展
from markdown.extensions.footnotes import FootnoteExtension
語法例子：
Footnotes[^1] have a label[^@#$%] and the footnote's content.
[^1]: This is a footnote content.
[^@#$%]: A footnote on the label: "@#$%".
腳注標記必須以 ^ 開始坚洽，后面可包含任意字符（支持空格）戈稿。
腳注注釋可以包含多行內(nèi)容，例如：
[^1]:
The first paragraph of the definition.
Paragraph two of the definition.
> A blockquote with
> multiple lines.
a code block
A final paragraph.
6. tables 擴展
from markdown.extensions.tables import TableExtension
7. admonition 擴展
提供醒目或注意段落讶舰。
from markdown.extensions.admonition import AdmonitionExtension
語法：
!!! type "optional explicit title within double quotes"
Any number of other indented markdown elements.
This is the second paragraph.
例子1：
!!! note
You should note that the title will be automatically capitalized.
轉(zhuǎn)為：
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>You should note that the title will be automatically capitalized.</p>
</div>
例子2：
!!! danger "Don't try this at home"
...
轉(zhuǎn)為：
<div class="admonition danger">
<p class="admonition-title">Don't try this at home</p>
<p>...</p>
</div>
8. nl2br 擴展
例子：
>>> import markdown
>>> text = """
... Line 1
... Line 2
... """
>>> html = markdown.markdown(text, extensions=['nl2br'])
>>> print html
<p>Line 1<br />
Line 2</p>
9. mdx_math 擴展
支持 MathJax 數(shù)學公式鞍盗。
安裝：
pip install python-markdown-math
使用：
import markdown
from mdx_math import MathExtension
md = markdown.Markdown(extensions=[MathExtension(enable_dollar_delimiter=True)])
md.convert('$e^x$')
# 輸出 '<p>\n<script type="math/tex">e^x</script>\n</p>'
另外還要在生成的 HTML 的 head 內(nèi)加入：
<script src='https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.5/latest.js?config=TeX-MML-AM_CHTML' async>
</script>
