Jekyll 的 markdown 解析真是蛋疼啊

[domty]

同一篇 markdown 文档，用 sublime 的 markdown preview 插件预览效果是正常的 结果发布到 jekyll 本地看效果，文档解析的一塌糊涂

话说有招儿吗。

我已经从 hexo 滚回 jekyll 一次了。。。

[Livid]

如果是用于文档网站的话，试试 pip install mkdocs

[ChiangDi]

Jekyll 可以换 makdown 解析器的。

[sparanoid]

不知道是什么解析器， Jekyll 最近换过默认的 Markdown parser ， Rouge 的效果好一些

[domty]

@Livid
不是网站啊， jekyll 就是一个生成静态博客的工具。

[domty]

@ChiangDi
还有其他的解析器吗，现在配的是 kramdown

[domty]

@sparanoid
我现在的 jekyll 是 3.1.2
本地 new 新项目的配置文件里给出的 markdown parser 还是 kramdown

rouge 怎么配？

[thcode]

Markdown 因为没有「标准」，所以各个解释器提供的特性是不一样的，如果 kramdown 不能满足需求，试试 redcarpet 。

[sparanoid]

@domty 啊，记错了， Rouge 是语法高亮的， Kramdown 的确是默认的 Markdown 解析，具体遇到了什么解析问题？

[domty]

@sparanoid

比如
```JavaScript

```
代码区块后面跟着 空行再跟着### 三级标题的话， jekyll 的就解析失败。 后面三级标题的###以及之后的 markdown 代码不解析直接显示出来了。

markdown preview 预览的效果是正常的

[sparanoid]

我试了下并没有问题，这是我的相关配置：
https://gist.github.com/sparanoid/7116f89b974299afc4bc49f7fe108921

[domty]

@sparanoid
这种问题很诡异，因为文章里相同模式的代码段有三处，但是只有这一处出现了错误。

gist 的代码段配完之后，我要在本地部署看效果需要安装其他什么 gem 吗

[wittyfox]

因为 Jekyll 和 Sublime 不一样，所以就是 Jekyll 坑。。。

[Bardon]

请用 ruby2.0.0 以上的版本，安装 jekyll 3.0 以上的版本。

然后，你本地 jekyll 的 style 配好了吗？你的 _config.yml 是啥？
在 kramdown 下你知道要启用什么才能使用 fenced code blocks 吗？
遇到问题为什么不去 jekyll 官网逛一遍呢？这是求学的态度？

好吧，我正好现在有点闲，啰嗦了几句。不过也把思路给你理顺了。

[jasonliao]

jekyll3.0 之后默认用 kramdown ，之前我升了之后，代码块也有很大的问题，例如在 ol 和 ul 里的代码块，但是现在也可以解决了。如果你也有这样的问题，可以找我 😎

[domty]

@Bardon

ruby version: 2.2.4
jekyll versuib:3.1.2
gem version:2.4.5.1

然而这个 markdown 文档放到 sublime 解析正常，传到 github 上看 markdown 解析正常，传到 cmd markdown 解析依然正常，就 jekyll 解析有问题，怪我咯？

_config.yml 里关于 markdown 的配置默认生成后我就没怎么动过

[Bardon]

@domty fenced code block 本地 jekyll 默认不启用
为什么不查官方文档？那怕过去了 24 小时
https://jekyllrb.com/docs/configuration/

你需要

[Bardon]

@domty https://jekyllrb.com/docs/configuration/#kramdown