Jekyll 包含不呈现 html 的降价文件

【问题标题】：Jekyll include markdown file not rendering htmlJekyll 包含不呈现 html 的降价文件
【发布时间】：2019-05-02 16:55:07
【问题描述】：

我有一个包含包含文件的 Jekyll 站点。在该包含文件中，我试图包含另一个文件：

<div class="api-doc api-off api-definition" id="debugging">{% include_relative _apiDocs/debugging.md %}</div>

但这会将降价显示为字符串：

--- title: API Reference | Debugging --- #### Debugging Turn on debugging: ```Javascript pbjs.setConfig({ debug: true }); ```

有没有办法让它呈现为 HTML？

【问题讨论】：

标签： html include markdown jekyll

【解决方案1】：

如果您使用 Kramdown 作为您的处理器，您可以通过将 markdown="1" 属性添加到父 div 来处理此问题：

<div class="api-doc api-off api-definition" id="debugging" markdown="1">{% include_relative _apiDocs/debugging.md %}</div>

如果没有，您可以对包含的 Markdown 应用过滤器以将其转换为 HTML (see the Jekyll docs on the markdownify filter)：

{%- capture debugging-doc -%}{% include_relative _apiDocs/debugging.md %}{%- endcapture -%}
<div class="api-doc api-off api-definition" id="debugging">{{ debugging-doc | markdownify }}</div>

【讨论】：