Mermaid2 Plugin in Material for MKDocs einrichten¶

Dependencies¶

pip install mkdocs-mermaid2-plugin

Konfiguration¶

1
2
3
4
5
6
7

  - pymdownx.extra:
      pymdownx.superfences:
        custom_fences:
          - name: mermaid
            class: mermaid
            format: !!python/name:mermaid2.fence_mermaid_custom
            #format: !!python/name:mermaid2.fence_mermaid # Plain Mermaid, without Material Theme

Nutzung¶

Über herkömmliche Codeblöcke mit Triple-Backtick. Baut auf dem Superfence-Plugin auf.

```mermaid
graph LR
    markdown --> mermaid
```

graph LR
    markdown --> mermaid

Lessons learned¶

• Workaround zur Theme-Steuerung auf Webseite funktioniert nicht.
• Plugin ermöglich Nutzung der offiziellen Themes, aber diese respektieren Light- / Darkmode nicht.