Mermaid Chart Writing

Write accurate Mermaid diagrams by mastering critical syntax rules and selecting the right chart type for your use case.

Critical Syntax Rules

These rules must be followed to avoid breaking diagrams:

Node IDs and Text

• No spaces in node IDs → Use camelCase or snake_case

  • Bad: A -x-> B (the x is treated as a connection style)
  • Good: nodeA --> nodeB

• Quote node labels with special characters → Use A["Process (main)"] not A[Process (main)]

  • Parentheses, colons, commas need quotes