有可能有sphinx MyST渲染美人鱼

Question

可以使用 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

的原因

Answer 1

mermaid完美融入MyST-parser.

你只需要这样称呼它 {mermaid}:

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

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

extensions = ['myst_parser', 'sphinxcontrib.mermaid']

有可能有sphinx MyST渲染美人鱼

It is possible to have sphinx MyST rendering mermaid

python-sphinx

mermaid

myst