pelican 使用笔记

记录一些使用 Pelican 写博客的经验。

Markdown

多级列表

官方的 Markdown 语法:

* list
  * sublist
  * sublist
* list

pelican 使用的是 python-markdown 来解析 markdown 文件, 而 python-markdown 的关于多级列表的语法跟官方的有点不一样:

* list
    * sublist
    * sublist
* list

子列表与父列表之间的对齐方式是:至少空出4个空格或1一个 Tab 键。 官方的语法兼容 python-markdown 的语法,所以不要担心兼容性。

语法高亮

python-markdown 使用 pygments 来实现语法高亮的功能,并且支持指定编程语言。

比如,指定代码用的是 Python 编程语言:

:::python
print 'hello, world'

效果:

print 'hello, world'

我用的比较多的语言标记:

  • :::text
  • :::python
  • :::django
  • :::html+django
  • :::bash
  • :::console
  • :::nginx
  • :::apacheconf

更多的语言标记,可以通过查看网站 Pygments — Python syntax highlighter 的源代码操作相关的语言标记(查看 id 为 flt_lang 的 select 的 option 值)。

注意:该语法不兼容官方 markdown 语法。

参考


Comments