【问题标题】:How to serve raw Markdown in Jekyll/GHpages?如何在 Jekyll/GHpages 中提供原始 Markdown?
【发布时间】:2017-08-23 00:16:38
【问题描述】:

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

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

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

我可以使用 keep_files 让它在原版 Jekyll 中工作,但我怀疑无法让 GHpages 看到这些文件,因为它们位于 _site 中,而 Git 会忽略这些文件。

【问题讨论】:

    标签: markdown jekyll github-pages


    【解决方案1】:

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

    <pre>
    # Your header
    
    Your paragraph, etc.
    </pre>
    

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

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

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

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

    这也会显示未渲染的 Markdown 文件。

    【讨论】:

    • &lt;pre&gt; 标签造成了麻烦,因为我将permalink: 设置为blah.md,所以我删除了它们,您的第二个版本运行良好。
    猜你喜欢
    • 1970-01-01
    • 1970-01-01
    • 2014-03-08
    • 1970-01-01
    • 1970-01-01
    • 2011-12-03
    • 1970-01-01
    • 1970-01-01
    • 1970-01-01
    相关资源
    最近更新 更多