Mermaid + Markdown support

https://github.com/mgaitan/sphinxcontrib-mermaid

Markdown support

You can include Mermaid diagrams in your Markdown documents in Sphinx. You just need to setup the markdown support in Sphinx via myst-parser . See a minimal configuration from the tests.

Then in your .md documents include a code block as in reStructuredTexts:

            sequenceDiagram
      participant Alice
      participant Bob
      Alice->John: Hello John, how are you?
    

For GitHub cross-support, you can omit the curly braces and configure myst to use the mermaid code block as a myst directive. For example, in conf.py:

myst_fence_as_directive = [“mermaid”]