如何在 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 文件:
- 将您的
.md
文件放在 _includes
目录中,例如_includes/raw.md
- 在任何地方创建一个页面(无论扩展名是
.md
还是 .html
),并使用 include
,在 <pre>
标签内:
---
---
<pre>{% include raw.md %}</pre>
(include
后的路径是相对于_includes
目录的。)
这也会显示未呈现的 Markdown 文件。
我希望我的 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 文件:
- 将您的
.md
文件放在_includes
目录中,例如_includes/raw.md
- 在任何地方创建一个页面(无论扩展名是
.md
还是.html
),并使用include
,在<pre>
标签内:
---
---
<pre>{% include raw.md %}</pre>
(include
后的路径是相对于_includes
目录的。)
这也会显示未呈现的 Markdown 文件。