we’ve swapped the mermaid theme component for pele here on meta, for testing purposes ![]()
what’s this about?
mermaid is two things:
- a syntax for describing diagrams with plain text (flowcharts, sequences, timelines…)
- a library that turns that text into an SVG in your browser
pele replaces #2. it reads the same syntax[1] but has its own engine and its own look ![]()
how does it work?
you write a ```mermaid code block in a post (or chat message). when that post is displayed, the theme component spots the block and has pele draw the diagram in place.
pele is only downloaded on pages that actually have a diagram, so it doesn’t slow down anything else.
why bother?
the mermaid library is big and “slow”. pele is 6x smaller, up to 500x faster, has no dependencies, theme-able with css variables, MIT licensed, and developed by obsidian’s team.
in practice: diagrams appear faster, and they match your site’s colors (light/dark included) without any extra work.
same ```mermaid syntax, so nothing to change in your posts.
here’s the theme component if you want to give it a try on your own site.
remove the mermaid component first, both can’t run side by side.
flowchart LR
A[mermaid] -->|swap| B[pele]
B --> C{looks good?}
C -->|yes| D[🎉]
C -->|no| E[reply here]
if you spot any visual bug, please
reply here with
- a link to the post (or the diagram source)
- a screenshot
- your browser and theme (light/dark)
thanks ![]()
up to mermaid 12.1.0, all diagram types ↩︎