text-to-diagram-site VS d2

As far as guidelines, I have spent time looking as well an never came away with a good answer. One useful website for comparing some of the best tools is https://text-to-diagram.com/. My personal favorite is D2. Still lacking a few layout features that I want, but it gets me 90% of the way there. The syntax is great for projects big to small, and it strikes the perfect balance between "create a diagram fast" and "feature rich". But in terms of actual guidelines, I would agree with another user that C4 actually tries to lay out some sort of guidelines.

One of those "text to diagram" contenders did a comparison website (open source) a while back: https://text-to-diagram.com/ (nomnoml isn't in there).

Community list of comparisons between Text to Diagram tools: https://text-to-diagram.com/

https://text-to-diagram.com/?example=sequence&b=mermaid

If you can get enough data out of the ticket system, maybe something like https://text-to-diagram.com/ will help.

We made a site to let people compare: https://text-to-diagram.com . (Mermaid maintainers contribute to it)

I think Mermaid is better than PlantUML to write something quickly.

But D2 looks very promising. I like the simpler and more intuitive syntax.

https://text-to-diagram.com/

have you seen https://text-to-diagram.com/ for comparing these flowcharts including mermaidJS and graphwiz as you mentioned and there are a few more there.

Yes, it's a limited generator, because it's like 20 lines long and not the point of the article.

If you want to compare Mermaid against D2, take a look at https://text-to-diagram.com. The maintainers of Mermaid have contributed to it.

For a comparison with other popular text-to-diagram tools: https://text-to-diagram.com (the maintainers of Mermaid have contributed to this).

While not embedded in markdown, I like d2 [1]. I can use it with org-babel to embed and view the diagrams on emacs. After using graphviz for years, the visual output seems more polished to me. With that said, I want to give pikchr a try.

[1]:https://d2lang.com/

In the next post I'll deep-dive into the D2 language which also has a huge set of features. Stay tuned.

That site is created by the maintainers of D2[1], so it might be biased, but I still think D2 has the friendliest syntax of the bunch, including nomnoml.

[1]: https://d2lang.com/

I've been using https://structurizr.com/ to automatically generate C4 diagrams from a model (rather than drawing them by hand). It works well with the approach for written documentation as proposed in https://arc42.org/. It's very easy to embed a C4 diagram into a markdown document.

The result is a set of documents and diagrams under version control that can be rendered using the structurizr documentation server (for interactive diagrams and indexed search).

I also use https://d2lang.com/ for declarative diagrams in addition to C4, e.g., sequence diagrams and https://adr.github.io/ for architectural decision records. These are also well integrated into structurizr.