text-to-diagram-site VS d2-playground

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).

https://play.d2lang.com/?script=qlDQtVOo5AIEAAD__w%3D%3D&ske...

I was going to ask why you don't have a web version but you already do. I'm going to play with this more today.

Have you thought about an "auto compile"/live mode where it changes as you edit the text? I think this adds a level of intuitiveness that would help new users explore.

Wow that's a very detailed catch, thanks for reporting! Made an issue: https://github.com/terrastruct/d2-playground/issues/33

A video can be a lot of work, it is quite challenging to produce a satisfying result. Instead, I suggest you to draw (here is a nice online tool to do that. If you prefer plain text, you can use d2) a Flowchart to represent your workflow. For someone who wants to understand a use case, it will be much quicker to look at a diagram rather than read or watch a video. And it will be easier for you to produce it.

We'll have our own API available for you to do this too. So you can make something on playground (https://play.d2lang.com) and then render the same way. E.g. https://github.com/alixander/test-render/blob/main/README.md

if you're talking about the playground, I did the initial version in a weekend or so (https://github.com/terrastruct/d2-playground), which includes building a WASM version of D2 (written in Go), putting a text editor, some UI stuff like dropdowns/menu, hooking it up together, layouts and responsiveness whatnot.

If you're talking about D2 language itself, ~2 devs over 3/4 of a year.

You can give it a spin to see if it's a fit for you here: https://play.d2lang.com