Hacker ApprovedDepartments

Beautiful Mermaid

Shares rank 7 of 11 diagram tools by recommenders

Recommended for rendering Mermaid diagrams as ASCII or Unicode text for terminals, AI workflows and DOM-free environments, though critics say the ASCII/Unicode mode doesn't work well.

Recommended for rendering Mermaid diagrams as ASCII or Unicode text for terminals, AI workflows and DOM-free environments, though critics say the ASCII/Unicode mode doesn't work well.

17 people gave an opinion

recommend it
12
criticize it
5
approval share
71%
Each figure is one person. RecommendsCriticizes

Recommended in 2 of 13 months

  1. November 2025: not recommended
  2. December 2025: not recommended
  3. January 2026: recommended
  4. February 2026: recommended
  5. March 2026: not recommended
  6. April 2026: not recommended
  7. May 2026: not recommended
  8. June 2026: not recommended
  9. July 2026: not recommended
  10. August 2026: not recommended
  11. September 2026: not recommended
  12. October 2026: not recommended
  13. November 2026: not recommended (month in progress)

Why it doesn’t carry the badge

  • 12 people recommend itNeeds 10 or more, met.
  • 2.4 recommenders for every criticNeeds 2 to 1 or better, met.
  • Recommended in 2 of 13 monthsNeeds 4 or more, not met.

The same three rules apply to every product, and the badge can’t be bought. How the badge works

What people say about it

The reasons people give, with the number of comments that give each one. Open a reason to read what they said.

Why people recommend it

Each mark is one comment

What people warn about

Each mark is one comment

  • ASCII output unreliable, differs from SVG

    “the ASCII/Unicode mode doesn't work all that well”

    Comment from 29 Jan 2026 in “Beautiful Mermaid”

    “they appear incorrect/inconsistent with the SVG”

    Comment from 29 Jan 2026 in “Beautiful Mermaid”

Other diagram tools people recommend

The four most recommended other diagram tools, with the same counts for each, so you can compare like for like. The tick on each bar marks the 2 to 1 line the badge needs.

Beautiful Mermaid compared with 4 alternatives
ProductRecommendCriticizeApprovalMonthsOwnedBadge
Mermaid934667%12—Approved
Reladraw28780%1——
SQL to ER diagram tool27196%2——
D2 diagram language21678%6—Approved
Beautiful MermaidThis page12571%2——
See all 11 diagram tools, ranked

What people said

All 17 comments that mention it, newest first. Each links to the original comment.

“anyone who has the extension installed is leveled up”

RecommendsComment from 13 Feb 2026 in “Monosketch”

“This tool will prove useful for posterity.”

RecommendsComment from 29 Jan 2026 in “Beautiful Mermaid”

“Just another AI copies the entire project and you get to put your name on it.”

CriticizesComment from 29 Jan 2026 in “Beautiful Mermaid”

“You solved a big problem.”

RecommendsComment from 29 Jan 2026 in “Beautiful Mermaid”

“This is a really cool project, and incredible traction - great job!”

RecommendsComment from 29 Jan 2026 in “Beautiful Mermaid”

“Quite nice for cloudflare workers as they don’t have access to DOM”

RecommendsComment from 29 Jan 2026 in “Beautiful Mermaid”

“While a bit nifty to have this available in the TS/JS ecosystem for web usage... I'm not sure it'd be my first thing if I were using such a thing as a CLI.”

MixedComment from 29 Jan 2026 in “Beautiful Mermaid”

“The main algorithms are 1:1 conversion.”

CriticizesComment from 29 Jan 2026 in “Beautiful Mermaid”

“the ASCII/Unicode mode doesn't work all that well”

CriticizesComment from 29 Jan 2026 in “Beautiful Mermaid”

“I think I ran into a bug, the "start" edge is not rendered.”

MixedComment from 29 Jan 2026 in “Beautiful Mermaid”

“A crazy amount of dropdown shadow (in the examples), stretched fonts (front page example).”

CriticizesComment from 29 Jan 2026 in “Beautiful Mermaid”

“Looks really useful to document complex applications”

RecommendsComment from 29 Jan 2026 in “Beautiful Mermaid”

“Looks awesome, perfect for a feature request”

RecommendsComment from 29 Jan 2026 in “Beautiful Mermaid”

“they appear incorrect/inconsistent with the SVG”

CriticizesComment from 29 Jan 2026 in “Beautiful Mermaid”

“The ASCII output is the missing piece for AI-assisted coding workflows.”

RecommendsComment from 29 Jan 2026 in “Beautiful Mermaid”

“This is great, I will definitely make use of this!”

RecommendsComment from 29 Jan 2026 in “Beautiful Mermaid”

“With this, you should be able to approximate swim lane diagrams, which is something Mermaid lacks.”

RecommendsComment from 29 Jan 2026 in “Beautiful Mermaid”

Counts come from 1,795,640 Hacker News comments, November 2025 to November 2026. How we count. Report a mistake.