为什么 Markdown 页面无法在我的 Github Pages 网站上正确呈现？

Question

我想将 Markdown 文件上传到我的 GitHub 页面站点。 VSCode 中的 Markdown 预览看起来很棒：

但我网站上的相应页面完全没有格式：

它甚至根本不像 Markdown - 它看起来像一个普通的文本文件。我真的很困惑，因为没有编译错误，而且其他人似乎发现 markdown 真的很直观。

到目前为止我尝试过的事情都无济于事：

• 将 .md 替换为 .markdown
• 创建额外的降价文件并重现问题
• 在不同的浏览器（safari、chrome）和不同的设备（mac、iphone）上运行

这是该页面的链接：http://madeleine2you.com/bookposts/dontforget/hardboiledwonderlandandtheendoftheworld.md。 如果可能有帮助，请访问网站：http://madeleine2you.com

Answer 1

浏览器不支持将 Markdown 转换为 HTML。

当您在存储库视图中查看 Markdown 文件时，Github 具有执行该转换的代码，但它不会将任何存储库预览格式应用于 Github Pages 站点。

您需要在构建时将 Markdown 转换为 HTML。 introductory documentation 最后链接到使用 Markdown 和 Jekyll 的指南。