有可能有狮身人面像 MyST 渲染美人鱼

编程问答 2022-05-03

问题描述

是否可以使用 MyST md 驱动程序在 \.md 文件中制作工作美人鱼？

目前我找到的唯一方法是

$ tail conf.py
extensions = [ 'recommonmark','sphinxcontrib.mermaid']
from recommonmark.transform import AutoStructify
def setup(app):
    app.add_transform(AutoStructify)
$

以下是用 recommonmark 呈现的：

```mermaid::

  graph LR
    a --> b
```

但不是 MyST-parser

我已在 MyST 中打开此问题：https://github.com/executablebooks/MyST-Parser/issues/366

注意：recommonmark 无法正确呈现表格，这就是我尝试使用 MyST-parser

的原因

解决方法

mermaid 与 MyST-parser 完美集成。

你只需要用 {mermaid} 来调用它：

```{mermaid}
graph LR
  a --> b
```

无需在 conf.py 中只定义一个 def setup(app):：

extensions = ['myst_parser','sphinxcontrib.mermaid']
mermaidmystpython-sphinx