Convert Graphviz DOT diagrams to Mermaid flowcharts for README files, Markdown documentation, design notes, and CI-generated docs.

npm install dot2mermaid

For local development in this repository:

npm install
npm test

Convert a DOT file and print Mermaid to stdout:

npx dot2mermaid ./examples/simple.dot

Write the Mermaid output to a file:

npx dot2mermaid ./examples/simple.dot -o flowchart.mmd

Choose a Mermaid flowchart direction:

npx dot2mermaid ./examples/subgraphs.dot --direction LR

When working from a clone of this repository, the same CLI is available through npm scripts:

npm run convert -- ./examples/simple.dot
npm run convert -- ./examples/simple.dot -o flowchart.mmd
npm run convert -- ./examples/subgraphs.dot --direction LR

import { convert } from 'dot2mermaid';

const mermaid = convert(dotSource, { direction: 'TB' });

DOT input:

digraph G {
  Start -> Build
  Build -> Test [label="Unit tests"]
  Test -> Deploy
}

Mermaid output:

flowchart TB
  Start["Start"]-->Build["Build"]
  Build["Build"]-->Test["Unit tests"]
  Test["Test"]-->Deploy["Deploy"]

Files:

• examples/simple.dot
• examples/simple.mmd

DOT input:

digraph Release {
  subgraph cluster_prepare {
    Plan -> Build
    Build -> Test [label=CI]
  }
  subgraph cluster_publish {
    Package -> Publish
  }
  Test -> Package
}

Mermaid output with --direction LR:

flowchart LR
  Test["Test"]-->Package["Package"]

  subgraph cluster_prepare
    Plan["Plan"]-->Build["Build"]
    Build["Build"]-->Test["CI"]
  end
  subgraph cluster_publish
    Package["Package"]-->Publish["Publish"]
  end

Files:

• examples/subgraphs.dot
• examples/subgraphs.mmd

See docs/conversion-rules.md for the supported DOT features, output shape, and current limitations.

Important behavior:

• digraph edges using -> become Mermaid --> edges.
• The default Mermaid direction is TB.
• Use --direction TB|LR|RL|BT to set the generated flowchart direction.
• Node labels are used as Mermaid node text when available.
• DOT subgraphs are emitted as Mermaid subgraph ... end blocks.
• Mermaid does not show a parent graph label for an unlabeled subgraph. Add a DOT label when that text must appear in rendered documentation.

Mermaid has a default maxTextSize limit of 50,000 characters. Large DOT files may render with Maximum text size in diagram exceeded. Adjust the Mermaid configuration in the renderer when needed.

dot2mermaid is released under the MIT license.