Troubleshooting

A Mermaid diagram does not render

Check syntax errors, safety restrictions, and per-slide limits in order.

Actual interfaceCheck Mermaid source and output
1 / 2
Review the code fence and diagram declaration.
Review supported source and its generated result in order.

Compare with a verified example

Copy the same diagram type from the Markdown reference, confirm it renders, and replace the content gradually. Check the opening and closing fences and the diagram type.

Syntax that is rejected

External links, click actions, HTML, init blocks, arbitrary style directives, and excessive node or edge counts are rejected. Split multiple diagrams across slides.

If the issue continues, contact us with the error message and time. Do not include passwords or Markdown content.

Contact →