是否有在markdown文件中使用HTML的解决方案 - 或显示纯HTML的整个额外页面的选项?
问题:我想在我的mkdocs生成的wiki中包含一个使用内联Javascript的html代码段。
尝试:我一直在搜索几个小时,但在这里或官方文档中找不到答案。
答案 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*
。