使用自定义主题更改mkdocs代码块

Question

我正在尝试在自定义主题中添加一些html元素（例如div），这些元素包装mkdocs从html输出生成的代码块。

mkdocs具有带三个反引号``` stuff ```的受限制的代码块，并且在生成html输出时会创建<pre><code (some stuff here)> stuff </pre></code>。我想知道自定义主题是否可以保留通过highlight.js类属性输出的pre和code标签，但又允许我将其包装在自定义div中以便将代码放入容器中的块与其他一些元素。

Answer 1

代码块是由Markdown解析器而不是MkDocs模板生成的。实际上，从Markdown为页面生成的HTML作为单个块传递到模板。因此，要更改Markdown的HTML输出，您需要使用Markdown扩展名。 MkDocs使用Python-Markdown和完全supports Python-Markdown extensions。

如果存在，则可以使用提供所需行为的现有third party extension。另外，您可以create your own自定义扩展名。