I suspect this was posted because I linked it in a comment in a different thread yesterday [1]. Mermaid is a great tool, especially for flowcharts. But as with

I suspect this was posted because I linked it in a comment in a different thread yesterday [1]. Mermaid is a great tool, especially for flowcharts. But as with other tools like Graphviz, it can be hard/impossible to build a clean structural diagram, where you have nodes that contain or stack other nodes, with flows and relationships between them. Invariably, I find that tools like Mermaid break down once there's a lot of components, even when using boxes and so on to group things. In particular, arrow routing is a weak point. Here [2] is an old diagram I once did in Mermaid. I was able to create two vertically-layered groups, but I was not able to prevent arrows from being messy. (There is, of course, one pair of arrows that need to cross in that diagram, but at least the software should be able to draw their intersection in a nicer way, e.g. by adding space around the arrow or have a little arch where one arrow jumps over the other.) [1] https://news.ycombinator.com/item?id=13324796 https://news.ycombinator.com/item?id=13324796 [2] http://i.imgur.com/awunH4m.png http://i.imgur.com/awunH4m.png