mermaid-to-image

What problem does it solve?

Many static publishing platforms and documentation sites do not render Mermaid diagrams directly, forcing authors to leave raw code blocks or manually produce images. This Skill automates detection and conversion of Mermaid code blocks into static PNG images, preserving diagrams in a format that renders consistently across sites.

Core Features & Use Cases

• Detects Mermaid code blocks across single files or entire directories and reports the number and locations of diagrams found.
• Renders diagrams to PNG using the mermaid.ink API with the required User-Agent header and saves images into a chosen project image directory.
• Replaces original Mermaid code blocks with relative or absolute Markdown image references and supports naming conventions and handling of multiple blocks per file.
• Use case: Convert diagrams in documentation or blog posts so they display reliably on GitHub Pages, Jekyll sites, or static blogs that do not support Mermaid.

Quick Start

Convert Mermaid code blocks in the specified Markdown file or folder into PNG images and replace each code block with an appropriate Markdown image reference.