如何在 Jekyll/GHpages 中提供原始 Markdown?

How to serve raw Markdown in Jekyll/GHpages?

我希望我的 Git 中心页面网站(长话短说)能够提供一些未呈现的 Markdown 页面。

如果我将 .md 文件保留在存储库的根级别,即使没有元数据,它也会转换为 html。我希望它保留 Markdown。

如果我将 .md 文件添加到 _config.yml 中的 exclude,那么它根本不会显示在 GHpages 中。

我可以使用 keep_files 在 vanilla Jekyll 中使用它,但我怀疑无法让 GHpages 查看这些文件,因为它们在 _site 中,它们被忽略了Git.

您可以 display plain text 在 Markdown 中,所以一种选择是将 .md 文件的内容包装在 <pre> 标签中:

<pre>
# Your header

Your paragraph, etc.
</pre>

或者,如果您不想修改 Markdown 文件:

  1. 将您的 .md 文件放在 _includes 目录中,例如_includes/raw.md
  2. 在任何地方创建一个页面(无论扩展名是 .md 还是 .html),并使用 include,在 <pre> 标签内:

---
---
<pre>{% include raw.md %}</pre>

include后的路径是相对于_includes目录的。)

这也会显示未呈现的 Markdown 文件。