在mkdocs中使用静态html

时间:2017-11-07 18:52:57

标签: html markdown mkdocs

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

问题:我想在我的mkdocs生成的wiki中包含一个使用内联Javascript的html代码段。

尝试:我一直在搜索几个小时,但在这里或官方文档中找不到答案。

1 个答案:

答案 0 :(得分:2)

只需在Markdown文档中包含HTML即可。 MkDocs没有记录这一点,因为这是标准的Markdown行为。事实上,Markdown rules州:

  

对于Markdown语法未涵盖的任何标记,您只需使用HTML本身。没有必要为它添加前缀或分隔它以表明您正在从Markdown切换到HTML;你只需使用标签。

     

唯一的限制是块级HTML元素 - 例如<div><table><pre><p>等 - 必须通过空行与周围内容分开,并且不应缩进块的开始和结束标记带有标签或空格。 Markdown非常聪明,不会在HTML块级标记周围添加额外的(不需要的)<p>标记。

     

...

     

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