The rendering is empty or shows an error
What happens. The source contains a Mermaid syntax error. The engine refuses to guess what you meant.
Your file is not affected. The text remains intact and the rendering failure did not modify it.
What to do. Switch to Source mode. The error message identifies the affected line.
If you just pasted a diagram found elsewhere, check that its first line declares a recognized family.
Balise says the diagram is too large
What happens. The source exceeds the size beyond which Balise stops attempting rendering to avoid blocking the application.
Your file is not affected.
What to do. Source mode remains fully usable. Split the diagram into several files to restore rendering.
I cannot edit an element in Visual mode
What happens. Balise disables edits it cannot apply safely. An ambiguous declaration or construction that the engine cannot precisely locate in the source stays intact instead of being approximately rewritten.
Your file is not affected, which is exactly why the edit is refused.
What to do. Edit the declaration in Source mode.
A moved element returns to its position
What happens. This is expected. Mermaid calculates the layout, and the format cannot remember arbitrary positions.
When your move corresponds to a meaningful grammar change, such as reordering, Balise applies it. Otherwise the element returns to its calculated position.
Your file is not affected.
What to do. Change the diagram direction or declaration order through structural navigation or Source mode to influence the layout.
A Mermaid block in Markdown does not update
What happens. The block editor works on an isolated draft. Markdown stays untouched until you click Apply.
Your document is not affected. Cancel leaves it exactly as it was.
What to do. Click Apply. If Balise rejects a line, it would close the block prematurely and truncate the surrounding document.