Mermaid To Image

Skill: Mermaid to Image

Convert ```mermaid code blocks in Markdown (or other text) files into PNG images, and replace the code blocks with image references. Useful for platforms that don't render Mermaid natively (GitHub Pages/Jekyll, Dev.to, etc.).

---

When to Use

• The user asks to convert Mermaid diagrams in a file to images
• The user wants to render specific Mermaid code blocks as PNG
• A publishing workflow requires static images instead of Mermaid code blocks

---

Workflow

Step 1: Identify target files

The user may specify:

• A single file: convert mermaid blocks in docs/architecture.md
• Multiple files: convert mermaid in all files under docs/
• A specific code block: convert the second mermaid block in README.md

Scan the target file(s) for ```mermaid code blocks. Report how many blocks were found and in which files before proceeding.

Step 2: Determine the image output directory

Check the project structure to find where images are typically stored:

# Look for common image directories
ls -d images/ img/ assets/ assets/images/ static/images/ docs/images/ 2>/dev/null