sphinx-mermaid

Mermaid graph support for sphinx generated documentations


Keywords
sphinxmermaid, mermaid, rst, reStructuredText, sphinx, diagram, mermaid-diagrams, mermaidjs, python, sphinx-extension
License
MIT
Install
pip install sphinx-mermaid==0.0.8

Documentation

Mermaid support for Sphinx documentation

Mermaid graphs support for sphinx generated documentations.

Install

pip install sphinx-mermaid

Setup in conf.py

In the conf.py file of your documentation, add the extension:

extensions = [
    ...,
    'sphinxmermaid'
]

Config Options

sphinxmermaid_mermaid_init can be set as a dictionary of values.

These will be passed to mermaid.initialize(). Find more info at MermaidJS

Example:

sphinxmermaid_mermaid_init = {
  'theme': 'base',
  'themeVariables': {
    'primaryColor': '#BB2528',
    'primaryTextColor': '#fff',
    'primaryBorderColor': '#7C0000',
    'lineColor': '#F8B229',
    'secondaryColor': '#006100',
    'tertiaryColor': '#fff'
  }
}

Usage

In your rst (or md) files, use the directive just like:

.. mermaid ::

    graph TD
    A --> B
    B -- Label --> C