内联 HTML 被 Jekyll 转义

Question

我在 github 页面中遇到内联 HTML 问题，其中内联 HTML 项目符号列表在表格中被转义。下表的行：

| Name | Value                 |
|------|-----------------------|
| one  | <i>foo</i>            |
| two  | <ul><li>bar</li></ul> |

呈现为：

<tr>
  <td>one</td>
  <td><i>foo</i></td>
</tr>
<tr>
  <td>two</td>
  <td>&lt;ul&gt;&lt;li&gt;bar&lt;/li&gt;&lt;/ul&gt;</td>
</tr>

项目符号列表按 GitHub UI 的预期呈现，但在 gh-pages 中，<ul>被转义。为什么？

Answer 1

这是由Kramdown设计的，它是在 GitHub 页面中呈现 Markdown 的 Markdown 处理器。

Kramdown 将每个新行视为一行，并且不会在表格单元格内呈现 Markdown 项目符号列表，并且不会呈现 HTML，而是将其转义并输出为单行文本。

您可以告诉 Kramdown 保留 HTML 并按原样输出，并使用nomarkdown 扩展名。{::nomarkdown}只需用...包装 HTML 代码即可{:/}

例如

| Name | Value                                   |
|------|-----------------------------------------|
| one  | {::nomarkdown}<i>foo</i>{:/}            |
| two  | {::nomarkdown}<ul><li>bar</li></ul>{:/} |