The problem with Mermaid in Slack
- Slack shows Mermaid as plain code — nobody reviews a diagram they can't see.
- Screenshotting your local Mermaid preview loses the source, so nobody can edit it later.
- A PNG alone does not explain which source is current or which discussion led to a change.
- Slack escapes characters like > and & inside messages, which silently breaks arrows like -->> when you copy code back out.



