doxygen markdown 防护代码块与缩进列表冲突

【问题标题】：doxygen markdown fenced code block conflict with indented listdoxygen markdown 防护代码块与缩进列表冲突
【发布时间】：2012-11-20 03:10:30
【问题描述】：

我观察到使用 doxygen 1.8.2，fenced code blocks 不能放在缩进级别超过 2 的 indented list 中（在降价文件中）。在下面的sn-p中：

- Level 1

~~~
printf("Hello world Level 1");
~~~

  - Level 2

  ~~~
  printf("Hello world Level 2");
  ~~~

    - Level 3

    ~~~
    printf("Hello world Level 3");
    ~~~

Hello world Level 1 和 Hello world Level 2 在输出中显示为代码 sn-ps，但 Hello world Level 3（及其周围的 ~s）显示为纯文本输出。

我犯了什么错误，或者这是一个已知的限制？

【问题讨论】：

标签： markdown doxygen

【解决方案1】：

这是一个限制（如果您愿意，也可以是错误）。

通常缩进 4 个或更多空格的所有内容都将逐字显示（代码块），但对于列出的相对缩进算作缩进（因此在您的示例中为 2 个空格）。由于在解析列表之前处理了围栏块，因此您会看到围栏块没有被视为这样（在此传递期间缩进太多），但也不会在稍后变成逐字部分（由于该传递期间的相对缩进） .

【讨论】：

@doxygen 有没有办法解决这个问题，以便可以在列表项之间交错使用围栏代码块？
绝对没有真正的解决方法可用。如果您将代码格式化为非纯文本格式（可以通过足够的缩进来完成），那么您将失去缩进。