# Pele Mermaid diagram renderer

12 Hacker News commenters recommended Pele Mermaid diagram renderer and 4 criticized it, November 2025 to November 2026. It was recommended in 1 of 13 months.

**Verdict:** A free Mermaid-syntax renderer that outputs themeable SVG diagrams with a nicer layout and easier embedding on other sites. Critics report that its layout gains are small and that the playground preview and dark-mode examples have problems.

## Why people recommend it

- Clean, readable diagram output (2 comments): "I always find Mermaid hard to read but Pele is a delight." ([source](https://news.ycombinator.com/item?id=50145018)) "The layout quality is very impressive!" ([source](https://news.ycombinator.com/item?id=50136382))
- Renders directly to SVG (2 comments): "I like the approach of rendering directly to SVG" ([source](https://news.ycombinator.com/item?id=50145001)) "Pele is great news for embedding Mermaid rendering in other places" ([source](https://news.ycombinator.com/item?id=50133359))
- Theming and dark mode (2 comments): "I like theming and controls you added to make it feel native to your site." ([source](https://news.ycombinator.com/item?id=50167417)) "Dark mode support is a good highlight." ([source](https://news.ycombinator.com/item?id=50141016))
- Good layout and subgraph handling (2 comments): "A flowchart subgraph keeps its own direction even when it links to nodes outside the subgraph." ([source](https://news.ycombinator.com/item?id=50137419)) "Pele not only takes care of all of that, but also manages a nicer layout!" ([source](https://news.ycombinator.com/item?id=50139527))

## What people warn about

- Layout gains look small (2 comments): "I couldn't see any major differences in the layout." ([source](https://news.ycombinator.com/item?id=50140005)) "first two examples are identical here" ([source](https://news.ycombinator.com/item?id=50143185))
- Dark-mode examples poorly styled (1 comments): "The examples are not very dark-mode friendly" ([source](https://news.ycombinator.com/item?id=50136733))
- Playground preview broken (1 comments): "the mermaid preview in the playground is broken" ([source](https://news.ycombinator.com/item?id=50136029))

## Alternatives hackers recommend

- [Mermaid](https://hackerapproved.com/p/mermaid.md): 93 recommend
- [Reladraw](https://hackerapproved.com/p/reladraw.md): 28 recommend
- [SQL to ER diagram tool](https://hackerapproved.com/p/free-sql-to-er-diagram-tool.md): 27 recommend
- [D2 diagram language](https://hackerapproved.com/p/d2.md): 21 recommend
- [PlantUML](https://hackerapproved.com/p/plantuml.md): 16 recommend

## Cite as

Hacker Approved, "Pele Mermaid diagram renderer", https://hackerapproved.com/p/pele/ (counts from 1,795,640 Hacker News comments, November 2025 to November 2026).