github - 我可以在 GitHub 页面中使用 Markdown 文件吗？

Question

由于GitHub wiki 不支持目录，我想将我的 md 文件放入 GitHub 页面中。然而，当我打开它们时，我发现它们根本没有被解释。GitHub 只是给了我原始文件。请参阅http://greenlaw110.github.com/Rythm/en/index.md。任何想法？

score 21 · Accepted Answer

文档对此并不是特别清楚，但鉴于 Markdown 渲染是由Jekyll完成的，我相信您需要他们所谓的“YAML 前端”来编译页面。所以试着把它放在文件的顶部：

---
title: Document Center
---

这应该足以触发 Jekyll。（然后你就可以开始花哨并开始使用布局等）

score 1 · Accepted Answer

您可能会获得原始文件的另一个原因（根据经验发现）index.md是，如果您碰巧也有一个类似名称的index.html文件。这会阻止 GH 页面。

删除index.html（在网站上）产生一个新index.html的带有解析的降价。原件index.md将不再可访问。

2 回答 2