Products · Product
Mermaid
Raised as a usability problem by 19 people on Hacker News over 10 years (2017–2026), in 13 threads.
No issue was raised by at least 3 people in 3 threads this year.
Every issue, all time, most people first
Creating sequence diagrams is terrible and time-consumingUnreviewed
20172026- Jumbled, hard-to-learn syntax for writing diagrams2025-05-05
- Diagrams need hacks, workarounds and config tweaks to render properly2025-01-17
- The process of creating sequence diagrams is terrible and time-consuming2023-06-16
Unreviewed issues were grouped by machine: Claude Haiku labelled each comment as a usability complaint, named what it's about and summed up the problem in a line, and a small model grouped similar problems. Nobody has checked them by hand. Expect mistakes.
The newest 19 complaints
- Confused about which button to press; expected fixed code shown immediately before applying2026-06-04
- Links in diagrams need obscure unsafe setting, not clearly documented2025-10-29
- Install fails with permissions errors and too many confusing setup choices2025-09-22
- Jumbled, hard-to-learn syntax for writing diagrams2025-05-05
- Whiteboard breaks, won't let user drag elements where wanted or avoid overlaps2025-01-17
- Diagrams need hacks, workarounds and config tweaks to render properly2025-01-17
- Layout controls are obscure and difficult to configure2024-08-16
- VoiceOver users get no semantic information from Mermaid charts2024-06-27
- Manual positioning tweaks make the markup almost unreadable2023-07-25
- The process of creating sequence diagrams is terrible and time-consuming2023-06-16
- Syntax is difficult to use and understand beyond simple examples2023-06-15
- Can't find how to resize diagram to fit a Word page2023-02-23
- Shows raw markup instead of a clear message when diagram text is invalid2023-02-23
- Automatic positioning of diagram elements is often infuriating and hard to control2022-05-06
- Error messages are cryptic and unhelpful, so users can't tell what went wrong2022-05-05
- Class diagrams and flowcharts become too cluttered to read beyond simple flows2020-06-15
- Hard to fix layout problems, so it takes longer than traditional diagramming tools2020-06-15
- Can't find a way to break text onto multiple lines in sequence diagrams2017-01-05
- Accordion navigation closes before the user can click on items2017-01-05