HN Hall of Fame Weekly email

Mermaid: Markdown-like generation of diagrams and flowcharts from text

github.com Software & code Software projects Software engineering Candidate
Screenshot of github.com captured 2026-07-20
Page preview · captured 2026-07-20

Resurfaced independently across 4 calendar years, with breakout response in 2 of them.

submissions
4
submitters
4
observed span
2014–2019
peak thread · 61 comments
453 pts
latest 20+ return · 2018-04-20
453 pts

Submission timeline

2007–2026

One slot for every year since HN launched. Height is that year's peak points; orange marks a 100+ point or 50+ comment breakout. Select a bar to open its strongest thread.

First comments on top threads

HN comment order

Mermaid is great, and I've used it for architectural diagrams of how tech stacks are put together, or data flows between apps. But it only produces marginally nicer-looking diagrams than Graphviz, and it optimizes badly against unnecessary line intersections (e.g. it's far too easy to end up with this, even in trivial diagrams: https://imgur.com/Tkpa9fD). My wish is for a diagram renderer with a smarter layout algorithm that heavily optimizes for direction and cleanness, understands grouping really well, and comes…

draw.io [1] has this hidden under Arrange->Insert->From Text and is also open source [2]. I work on the project. [1] https://www.draw.io [2] https://github.com/jgraph/draw.io

Awesome, what a cool library. I almost wish I had even an inkling of notion of need for it, just to try it out. Nice job, well done. EDIT: And the syntax and semantics are clear from the examples. Again, well done.

The first top-level comment from each of the four biggest threads, in HN’s own order. Excerpts are shortened; open a comment for full context.

Breakout years
2

100+ points or 50+ comments

Total points
774

reference only — not used in Hall rules or ranking

Total comments
117

reference only — not used in Hall rules or ranking

Every submission