在 mkdocs 中使用静态 html

Question

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

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

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

Answer 1

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

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

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

...

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