It's better when it's simple

User Tools

Site Tools


Mermaid Plugin

Compatible with DokuWiki

  • 2022-07-31 "Igor" yes
  • 2020-07-29 "Hogfather" yes
  • 2018-04-22 "Greebo" yes
  • 2017-02-19 "Frusterick Manners" unknown

plugin Provides support for the diagramming tool Mermaid

Last updated on

This plugin provides support for the diagramming tool Mermaid. Mermaid is a JavaScript based diagramming and charting tool that renders Markdown-inspired text definitions to create and modify diagrams dynamically.


Install the plugin using the Plugin Manager and the download URL above, which points to latest version of the plugin. Refer to Plugins on how to install plugins manually.


graph TD

results in

Mermaid supports multiple other diagrams besides the shown flowchart, for example:

  • Sequence diagrams
  • Gantt diagrams
  • Class diagrams
  • Git graphs
  • User Journey diagrams

For full information, see


The full syntax is

<mermaid #width #height>

#Content specifies the code that gets passed on to Mermaid for rendering. #Width and #Height are optional parameters and are used to specify the size of the container of the diagram. They can take any value supported by CSS, for example <mermaid 100% 1cm>. Default value is auto.

For more examples and details on the mermaid syntax, see

Configuration and Settings

There is only one setting. You can choose which Mermaid version you want to use:

  • the locally hosted version
  • the remotely hosted, currently available, latest version
  • a remotely hosted specific version


In the file action.php, change the logLevel of Mermaid to debug for easier debugging by setting MERMAIDLOGLEVEL to debug.

Change Log

  • 2023-02-28
    • Update to support the new Mermaid v10.0 (Feb 21, 2023)
  • 2023-02-03
    • Added setting to choose between a locally or remotely hosted mermaid file
  • 2023-01-26
    • Initial release with Mermaid v9.3 (Dec 15, 2022)
plugin/mermaid.txt · Last modified: 2023-02-28 11:13 by robertweinmeister

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki