html - 在 mkdocs 中使用静态 html

Question

是否有在 Markdown 文件中使用 HTML 的解决方案 - 或显示一个纯 HTML 的整个额外页面的选项？

问题：我想在我的 mkdocs 生成的 wiki 中包含一个 html 片段，该 wiki 使用了一些内联 Javascript。

试过：我已经搜索了几个小时，在这里或官方文档中找不到答案。

Answer 1

只需在您的 Markdown 文档中包含 HTML。MkDocs 没有记录这一点，因为这是标准的 Markdown 行为。事实上，Markdown 规则规定：

对于 Markdown 语法未涵盖的任何标记，您只需使用 HTML 本身。无需为它加上前缀或定界以表明您正在从 Markdown 切换到 HTML；您只需使用标签。

唯一的限制是块级 HTML 元素（例如<div>、<table>、<pre>、<p>等）必须用空行与周围的内容隔开，并且块的开始和结束标记不应使用制表符或空格缩进。Markdown 足够聪明，不会<p>在 HTML 块级标签周围添加额外的（不需要的）标签。

...

请注意，Markdown 格式化语法不会在块级 HTML 标记中处理。例如，您不能*emphasis*在 HTML 块中使用 Markdown 样式。