read-the-docs - 编号列表中的代码块弄乱了编号 python-markdown/mkdocs

Question

我在 mkdocs 中为我的一个项目创建了一个说明列表，我相信它使用 python-markdown 作为其 Markdown 引擎。但是，当我尝试在列表中的数字之间放置一个围栏代码块时，它会导致编号错误。

一个让我失望的例子(我也尝试在每个反引号栅栏和实际单词之间放置换行符，但它仍然弄乱了编号):

1. Click this
```
some code
```
2. Click that

呈现如下内容:

1. Click this

some code

1. Click that

然后，当我尝试缩进它时，它只会弄乱渲染:

1. Click this
    ```
    some code
    ```
2. Click that

到

1. Click this ``` some code ```
2. Click that

是的，制表符有效，但如果我想用```语言。有没有一种方法既可以保留围栏代码块，又可以保留列表编号。

Answer 1

Pyhton-Markdown 的 documentation具体说明(在红色警告框中):

Warning: Fenced Code Blocks are only supported at the document root level. Therefore, they cannot be nested inside lists or blockquotes.

因此，您必须使用缩进代码块。当然，要将其保留为代码块并嵌套，您需要将其缩进两次:

1. Click this

        some code

2. Click that

如果你想为你的代码块定义一种语言，你需要启用 CodeHilite使用 markdown_extensions 的扩展mkdocs.yml 配置文件中的配置选项:

markdown_extensions:
    codehilite:
        use_pygments: False

通过将 use_pygments 选项设置为 False，CodeHilite 将输出与围栏代码块相同的 HTML，然后由 MkDocs 主题提供的 JS 库突出显示。

然后你需要使用CodeHilite定义语言的语法:

1. Click this

        :::language    
        some code

2. Click that