# Mermaid

> Find a mermaid diagram embedded in a markdown file, write it out to a separate mermaid input file

- Skill: `wazzamo/mermaid` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add wazzamo/mermaid`
- Raw SKILL.md: https://api.skillmd.com/api/skills/wazzamo/mermaid/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: WazzaMo (https://skillmd.com/u/wazzamo)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/wazzamo/mermaid

---

Find a mermaid diagram embedded in a markdown file, write it out to a separate mermaid input file
with the file name image-{basename}-{description}.mmd where "basename" is the base filename from the markdown file 
and "description" is a short description of the mermaid image. Run script/run-mermaid.sh image-{basename}-{description}.mmd image-{basename}-{description}.png and then replace the mermaid text with a reference to the PNG image of the form:

```text
![{description}](./image-{basename}-{description}.png)
```

So that the markdown file refers to the rendered image.