8

我正在使用 Jekyll，并希望{% include... %}在 markdown 文件中包含一段 HTML，而不需要进一步处理该 HTML，即，然后由 markdown 处理器处理，就好像它只是内联 HMTL。

注意：我使用的是redcarpet markdown（而不是 kramdown）。

这可以用 Jekyll 插件处理吗？

我创建了一个 GitHub存储库md-include-html，其中包含以下文件来演示我的问题。

1._layouts/default.html包含：

<div>
{{ content }}
</div>

2.md-page.md包含：

---
layout: default
---
A

{% include_relative html-snippet.html %}

B

3.html-snippet.html包含：

</div>
<!-- Some arbitrary HTML for {{ page.path }} -->
<div>

请注意，我首先尝试关闭将要介绍的 div，_layouts/default.html然后在最后打开一个新 div。

这导致_site/md-page.html：

<div>
<p>A</p>

<p></div>
&lt;!-- Some arbitrary HTML for md-page.md --&gt;
<div></p>

看看我的评论是如何被处理的，我的内容是如何包装的<p>...</p>。

似乎包含发生在降价处理之前，并且没有办法告诉降价处理器以不同的方式处理包含的文本。

所以我可以在 HTML 文件中包含类似这样的降价（参见html-page.html我的仓库）：

{% capture snippet_content %}
{% include_relative md-snippet.md %}
{% endcapture %}
{{ snippet_content | markdownify }}

但我不能在降价文件中包含 HTML。

如果没有降价功能（Liquid 中所做的任何事情基本上都发生得太早）暂时禁用降价处理，我无法解决这个问题。

例如

A

<markdown-off>{% include_relative html-snippet.html %}</markdown-off>

B

是的，我知道标签看起来不太像降价，但你明白我的意思。

有没有办法用 Jekyll 插件来做到这一点？我查看了 Jekyll 文档的插件页面中提到的那些，但没有立即发现任何东西。

4

2 回答 2

4

现在才碰到这个问题。我正在使用包含在 Jekyll 中的 .md 文件中添加 html 片段。如果你使用 Kramdown，你可以在你的包含片段中添加一个 markdown 属性。

<div markdown="0"> !-- some html you don't want processed --> </div>

这似乎有效。

于 2019-05-13T23:56:03.673 回答
2

我知道一个老问题，但你试过把它包装在{% raw %} {% endraw %}?

尝试

</div>
{% raw}
<!-- Some arbitrary HTML for {{ page.path }} -->
{% endraw %}
<div>

这应该停止模板引擎的处理。

将注释缩进 4 个空格意味着 markdown 会将其视为代码，但 Liquid 仍将处理{{ page.path }}

于 2016-01-03T19:29:57.497 回答