Jekyll发布的静态Blog中Markdown解析问题

Question

遇到的问题是这样的。我在本地用Jekyll新建了一个Blog，写好一篇post后发布到Git托管的Page上。在互联网上访问文章页面，就会发现是这个样子的：

显然，这里面有一些Markdown格式没有被正确解析成HTML，在下面给出的地址中可以看到更多错误。我尝试把同样的内容发布在Github上，结果是一样的。我在本地发布（# jekyll serve），就会发现内容格式解析正确，但会有如下提示：

Generating... Maruku#to_s is deprecated and will be removed or changed in a near-future version of Maruku.

图中的文章在这里，这份提交的post在这里，另一篇跟图中文章格式类似的测试帖在这里。

并不指望能在社区直接找到解决方案，但求提供解决问题的思路，我会顺着可行的思路寻找答案。有兴趣的小伙伴可一起尝试解决。

Answer 1

可能你的git markdown解析器和你本地的不同，导致某些语法不兼容

Answer 2

markdown解析器的差异问题。强烈建议搭建github pages本地环境预览一下。搭建方法见：https://help.github.com/articles/using-jekyll-with-pages。

注意：千万不要使用jekyll官方引擎(http://jekyllrb.com/)生成静态html, 一定要用github pages的自己的引擎：bundle exec jekyll serve 。 因为github pages的使用jekyll与jekyll官方的在语法上有很大差别—— 这会导致用官方jekyll测试生效，推到github pages后却不会生效。

为避免因为本地github-pages 引擎版本太旧或一些潜在的bug， 记得及时更新：bundle update

Answer 3

或者试试在行的末尾加上两个空格？

Answer 4

同问，什么愿意