我可以在 GitHub 页面中使用 Markdown 文件吗？答案

【问题标题】：Can I use a Markdown file in a GitHub page?我可以在 GitHub 页面中使用 Markdown 文件吗？
【发布时间】：2021-02-05 06:55:50
【问题描述】：

由于the GitHub wiki does not support directories，我想把我的md文件放到GitHub页面中。但是，当我打开它们时，我发现它们根本没有被解释。 GitHub 只是给了我原始文件。见http://greenlaw110.github.com/Rythm/en/index.md。有什么想法吗？

【问题讨论】：

【解决方案1】：

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

---
title: Document Center
---

这应该足以触发 Jekyll。（然后您可以get fancy 并开始使用布局等）

【讨论】：

【解决方案2】：

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

删除 index.html 会生成（在网站上）带有已解析降价的新 index.html。原来的index.md 就不能再访问了。

【讨论】：