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

时间:2017-08-23 00:16:38

标签: markdown jekyll github-pages

我希望我的GitHub页面网站(长篇故事)能够提供一些未经渲染的Markdown页面。

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

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

我可以使用keep_files在vanilla Jekyll中使用它,但我怀疑GHpages无法查看这些文件,因为它们位于_site内,Git会忽略它们。

1 个答案:

答案 0 :(得分:1)

您可以在Markdown中display plain text,因此可以选择将.md文件的内容包含在<pre>标记内:

<pre>
# Your header

Your paragraph, etc.
</pre>

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

  1. 将您的.md文件放在_includes目录中,例如_includes/raw.md
  2. 在任意位置创建页面(如果扩展名为.md.html,则无关紧要),并在include标记内使用<pre>
  3. &#13;
    &#13;
    ---
    ---
    <pre>{% include raw.md %}</pre>
    &#13;
    &#13;
    &#13;

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

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