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

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

遇到的问题是这样的。我在本地用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在这里,另一篇跟图中文章格式类似的测试帖在这里。

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


同问,什么愿意


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


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


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

【热门文章】
【热门文章】