Jekyll 包含 Markdown 文件不呈現 html

Question

我有一個帶有包含文件的 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？

Answer 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（請參閱關於markdownify過濾器的 Jekyll 文檔）：

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