Mermaid diagrams are awesome, the usual pain points which I am trying to solve in https://mdview.io is to allow to fix broken diagrams visually: you hit Quick Fix and then given 3 fix propositions to choose from. Sounds complicated but it works in 80% of times