Live data from Hacker News

Mermaid: Generation of diagrams like flowcharts or sequence diagrams from text

github.com

91–100 of 110 posts

Re: Mermaid: Generation of diagrams like flowcharts or sequence diagrams from text

#91

I have an almost exhaustive list [1] of browser based text to diagram tools. Some specialised tools (like https://sequencediagram.org/ ) so much better at what they do than any generic ones like mermaid. [1] https://xosh.org/text-to-diagram/

Nice list, thanks for compiling it. It looks like you have "textik" in there twice in positions 11 and 13.

Re: Mermaid: Generation of diagrams like flowcharts or sequence diagrams from text

#92

I have an almost exhaustive list [1] of browser based text to diagram tools. Some specialised tools (like https://sequencediagram.org/ ) so much better at what they do than any generic ones like mermaid. [1] https://xosh.org/text-to-diagram/

They might be "better", but Mermaid works offline (there's a cli) which makes it a much better choice, along with PlantUML. An online tool might be good for making one off things you know you won't ever need to change, but my main use case for these tools is documentation which, naturally, needs to change over time.

I think almost all of the tools I listed are offline. They do load in browser, but from there they don't use server to render diagrams. Some aggregator tools like Kroki is of course not offline though.

Re: Mermaid: Generation of diagrams like flowcharts or sequence diagrams from text

#93

I have an almost exhaustive list [1] of browser based text to diagram tools. Some specialised tools (like https://sequencediagram.org/ ) so much better at what they do than any generic ones like mermaid. [1] https://xosh.org/text-to-diagram/

But they are browser based.

Yes. Most of them are offline even if they load in browser. Diagram is rendered right inside the browser.

Re: Mermaid: Generation of diagrams like flowcharts or sequence diagrams from text

#94
post #82

Earlier quoted context omitted.

That’s a pretty major downside, since broad in-browser support (GitHub, Notion etc) is arguably Mermaid‘s USP.

It's not too bad if you're prepared to set up a rendering pipeline using a static site generator like mkdocs. This will get you much better results than just letting GitHub et al render markdown in whatever style they please.

We're quite happy with mermaid though, not sure what's the issue with it?

Re: Mermaid: Generation of diagrams like flowcharts or sequence diagrams from text

#95
post #31
post #10

Earlier quoted context omitted.

I use it and see it many times per month as it’s the preferred way of sticking graphics and diagrams in markdown in git repos and generated static sites. It’s so handy for putting a sequence diagram in your docs and then tracking the changes over time using git. I’m curious what other software developers use if not this. I’ve tried specific graph and drawing tools like lucid and Visio, but the simplicity of mermaid i…

Re what other developers use. I tried mermaid and other text to diagram tools for work, but, as mentioned above, found them lacking. Most companies / teams I know of use something like excalidraw or miro. Definitely matches your simplicity requirements, but, obviously, no git blame

I haven’t tried excalidraw, but don’t like miro as I want my docs embedded with the repo, not linking out to a third party.

I like miro for brainstorming and such.

Re: Mermaid: Generation of diagrams like flowcharts or sequence diagrams from text

#96
post #10

Earlier quoted context omitted.

I use it and see it many times per month as it’s the preferred way of sticking graphics and diagrams in markdown in git repos and generated static sites. It’s so handy for putting a sequence diagram in your docs and then tracking the changes over time using git. I’m curious what other software developers use if not this. I’ve tried specific graph and drawing tools like lucid and Visio, but the simplicity of mermaid i…

> And I don’t know anything else that shows git blame for who changed what in my diagram, when. You could do this with any diagrams-as-code tool, no?

Such as?

Re: Mermaid: Generation of diagrams like flowcharts or sequence diagrams from text

#97

I have an almost exhaustive list [1] of browser based text to diagram tools. Some specialised tools (like https://sequencediagram.org/ ) so much better at what they do than any generic ones like mermaid. [1] https://xosh.org/text-to-diagram/

That's an amazing list! If you're writing in asciidoc like I generally do, here's the subset that you can write directly in your document: https://docs.asciidoctor.org/diagram-extension/latest/

Re: Mermaid: Generation of diagrams like flowcharts or sequence diagrams from text

#98
post #78

I much prefer d2 https://d2lang.com/ Only downside is AFAIK no in-browser renderer.

The other downside is that D2 is a thinly-veiled Open Core project and you'll be forever stuck with yet another company trying to get money from you:

https://d2lang.com/tour/tala/

> Proprietary layout engine developed by Terrastruct

> TALA is a separate install from D2, to keep a clean cut between 100% free and open-source D2, and proprietary, closed-source TALA.

The two non-proprietary layout engines are 1) Dagre, a port of ideas from Graphviz to Javascript, where the only benefit over Graphviz seems to be "it's in Javascript!" 2) ELK, a fairly naive layout engine that makes non-symmetrical graphs with oddly crooked lines.

Re: Mermaid: Generation of diagrams like flowcharts or sequence diagrams from text

#99
post #78

I much prefer d2 https://d2lang.com/ Only downside is AFAIK no in-browser renderer.

The other downside is that D2 is a thinly-veiled Open Core project and you'll be forever stuck with yet another company trying to get money from you: https://d2lang.com/tour/tala/ > Proprietary layout engine developed by Terrastruct > TALA is a separate install from D2, to keep a clean cut between 100% free and open-source D2, and proprietary, closed-source TALA. The two non-proprietary layout engines are 1) Dagre, a…

It's weird to me that TALA is considered the "special sauce" layout engine, because I've only ever had it produce extremely weird layouts for me.

I always tend to end up using ELK.

Re: Mermaid: Generation of diagrams like flowcharts or sequence diagrams from text

#100
post #94

Earlier quoted context omitted.

It's not too bad if you're prepared to set up a rendering pipeline using a static site generator like mkdocs. This will get you much better results than just letting GitHub et al render markdown in whatever style they please.

We're quite happy with mermaid though, not sure what's the issue with it?

Well it just can't do as much as many other tools.
Post reply on HN