Live data from Hacker News

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

github.com

61–70 of 110 posts

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

#61

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.

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

#62
All I really want is something that can diagram out 30+ microservices and interconnections without getting ugly.

graphviz does okay, but I kinda want some extra levels of grouping to keep services in the same k8s namespace close together.

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

#63
post #52

I just used Mermaid for multiple sequence diagrams from build-steps sequences in a video talk I did on comparing build systems - https://www.youtube.com/watch?v=L67ri_xe2oQ (slides - https://paulhammant.com/google-style-dag-build-systems/ ). The new boost for me was GPT4o. It was able to quickly make what I wanted from the build logs alone, though it took some hand tweaking too. A new (or very old) problem after that…

Interesting slides, it's always nice to see different ways to set up these kinds of systems and with a practical git repo to boot!

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

#64

All I really want is something that can diagram out 30+ microservices and interconnections without getting ugly. graphviz does okay, but I kinda want some extra levels of grouping to keep services in the same k8s namespace close together.

Are clusters not enough?

They can be nested.

https://graphviz.org/Gallery/directed/cluster.html

https://github.com/ReneNyffenegger/about-Graphviz/blob/maste...

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

#66
post #57

Earlier quoted context omitted.

I was under the impression mermaid is a wrapper around graphviz dot.

No, it's an independent, JS-only implementation, and it's way, way less featureful.

I believe it uses an cross compiled version of dot in js

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

#67

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/

The main benefit for me to just know and primarily use mermaid is that it integrates with markdown in Azure DevOps and GitHub seamlessly. No need for a text to image build step or similar.

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

#68
post #33

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/

I wish WebSequenceDiagrams was further up your list. I guess I have some work to do. When I made it, nothing like mermaid, plantUML,lucid charts existed. The syntax of most tools was based on Java or graphviz and overly verbose. I was writing an email to a colleague at BlackBerry and wrote out the sequence diagrams as text. I spent the next week making a script to convert it to an image and put it online. Many other…

Thank you so much for WSD.. I've used it extensively for at least a decade. We even self hosted it at one place after I pushed for it.

It was indeed pioneering in its day, though I find the default mermaid integration in the likes of Notion make it the (generic) goto for the team now.

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

#69
post #33

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/

I wish WebSequenceDiagrams was further up your list. I guess I have some work to do. When I made it, nothing like mermaid, plantUML,lucid charts existed. The syntax of most tools was based on Java or graphviz and overly verbose. I was writing an email to a colleague at BlackBerry and wrote out the sequence diagrams as text. I spent the next week making a script to convert it to an image and put it online. Many other…

Thank you so much for your work!

WebSequenceDiagrams has been my go to for years, and I'd be basically brainstorming straight in it in lieu of pen and paper. I laughed the day one of my colleague was explaining his issue on the whiteboard and he was writing it "A->B: some action" style instead of the actual box and arrow sequence, it just became part of our culture I think.

I had to move on when I couldn't get it approved at the place I worked, and nowadays PlantUML tools have become "good enough" (still wish Notion had PlantUML support instead of mermaid...), but I'm incredible thankful your service is still up and running.

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

#70

IMO mermaid is awesome, but for two somewhat indirect reasons: - There’s an almost wysiwig editor for mermaid at https://www.mermaidchart.com/play . It’s very convenient and appropriately changes the layout as you draw arrows! - Notion supports inline mermaid charts in code blocks (with preview!) It’s awesome for putting some architecture diagrams in Eng docs.

Hugo does this as well.
Post reply on HN