Python Markdown的拓展

通过对 Python Markdown的拓展来获得类似 django 官方文档的阅读体验，发现一些很细节的文档内容展现形式，能够极大地提高文档的阅读体验。阅读其他技术文档时也会经常发现类似的内容展现形式。

确定需求

阅读技术类文档经常会看到这么几种内容： Code block 、 Admonition 、 Command tab 。中文不太好翻译，来看一下实际的效果就知道了，下面是 django 中这几种内容的展现形式。

Code block

代码块的上方有一个 header，左边显示代码块所在文件路径，这样示例代码应该放在哪个文件就一目了然；右边是一个按钮，点击即可复制整个代码块中的内容。

Admonition

admonition 用来展现一些提示、警告等内容，文档中经常见到的有危险（danger）、警告（warning）、注意（attention）、重要（important）、提示（hint）等内容，不同类型的内容通常会以不同的背景和字体颜色区分。

Command tab

技术类文档中少不了系统命令，很多相同效果的命令在不同操作系统中的字符内容是有一定差异的。写的不太好的文档通常只给出 Linux 下的执行命令；好点的文档则将执行命令分别列出；而 django 文档的处理就非常细节，以 tab 切换的形式给出不同系统下的命令执行方式，这样既能够列出不同系统下的执行命令，又不会重复占用文档的内容空间，提高了文档的紧凑感和阅读时的流畅性。

我的需求就是要在自己博客文章中实现以上三种内容展现效果。

方案研究

博客文章的标记语言采用的是 Markdown，具体的实现采用的是 Python-Markdown/markdown 这个开源库。这个库不仅实现了 Markdown 标准语法的解析，还提供了很多丰富的拓展语法。

例如需求中提到的 admonition 功能，通过添加 markdown.extensions