Notes on "Mermaid"

1 note in total
Jan 29, 2026

Beautiful Mermaid (via). Mermaid is the de facto tool for describing diagrams in plain text and embedding them in Markdown. GitHub supports it, for example1. But I’ve never liked the default theme — that’s why I still haven’t adopted it.

Today I found out the Craft team felt the same way, and they released a new rendering engine for Mermaid diagrams. It outputs both SVG and ASCII art, and the default theme looks great.

I haven’t looked into it deeply yet, but it looks promising at a glance. I hope it becomes a catalyst for better-looking diagrams — either by maturing into a drop-in replacement that the ecosystem adopts, or by pushing the Mermaid team to ship a better default theme.

Beautiful MermaidBeautiful Mermaid

Mermaid's default themeMermaid's default theme

  1. GitHub blog post: Include diagrams in your Markdown files with Mermaid; GitHub documentation: Creating diagrams

#tech29 Jan 29, 2026
Page 1 / 1