python 程序来渲染 markdown 文件到 HTML 的过程

安装必备的软件

  1. markdowns
  2. pygments

主要使用如上两个软件包,其他软件包可以根据情况使用。

实际渲染时,为了让代码着色,还需要一些额外的操作,才能让最终显示的代码有颜色。

一些命令行命令

1
markdown2 --extras code-friendly,footnotes,fenced-code-blocks celery_实践.md > xxx.html

命令行下生成 html 文件。

1
pygmentize -S colorful -f html > codehilite.css

生成 css 文件,需要注意的是,这里生成了的 css 文件,还需要引入才行。

要想让 html 文件更加好看,需要额外的一些工作,比如给 pre 标签增加背景和框

1
2
3
4
5
6
7
8
pre {
margin: 10px 0 0 0;
padding: 10px;
border: 0;
border: 1px dotted #785;
background: #f5f5f5;
}

实际操作中,应该是这个文件只生成 body 中的内容,其余的头部和尾部等信息,
使用通用的文件来渲染。

参考资料

http://sebastianraschka.com/Articles/2014_markdown_syntax_color.html