ZMonster's Blog 巧者劳而智者忧,无能者无所求,饱食而遨游,泛若不系之舟

Github建议将Pages Site的Markdown解析器替换为Kramdown

4月15日,Github向用户发出邮件,建议使用Github Pages服务的用户,应当将使用Github Pages服务搭建的站点的Markdown文件解析器替换成 Kramdown ——在此之前,应该有不少用户是使用 Maruku 的,而据Github的邮件, Maruku 已经过时。

以下为Github邮件内容:

The page build completed successfully, but returned the following warning:

Your site is using Maruku, the default Markdown interpreter. Maruku is now obsolete and may cause builds to fail for sites with invalid Markdown or HTML. See https://help.github.com/articles/migrating-your-pages-site-from-maruku for more information on upgrading to a newer Markdown interpreter.

在2013年10月,Maruku的作者Benjamin Hollis在 Maruku is obsolete 一文中说道:

All of the things I wanted to do in Maruku for 1.0.0 were in fact already done in Kramdown – better code organization, better modularity and extensibility, good documentation, a better parser, and improved performance

并且在Kramdown 1.0.0发布后,Benjamin Hollis自己也转向了使用Kramdown。从Github上的Commits记录来看,Maruku也已经有三个月没有任何更新了。所以说,嗯,Github说,是时候换个更好的Markdown解析器了,不然有可能你的网站可能会在解析的时候发生问题。

修改方法也很简单,在_config.yml这个文件里进行修改,将:

markdown: maruku

替换成:

markdown: kramdown

一开始我收到邮件,有点诧异,因为我的文章都是用org-mode编写然后发布成html,所以我就没在_config.yml里设置Markdown解析器,查了一下,原来Maruku是Jekyll默认的Markdown解析器。所以你如果和我一样,保险起见,在_config.yml里显式地指定解析器为Kramdown吧。