git - 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

同問，什麼願意