mermaid-export

What problem does it solve?

Mermaid diagrams created or edited in documents are often left unrendered, resulting in missing visuals when sharing or publishing. This Skill renders Mermaid blocks to PNG images immediately after creation or modification, BEFORE committing, ensuring diagrams are always visible.

Core Features & Use Cases

• Automatic rendering: Converts all Mermaid code blocks in documents to PNG images.
• In-document updates: Replaces the Mermaid code blocks with image references and preserves the original Mermaid source inside a collapsible details block for easy editing.
• Broad format support: Processes files with extensions such as .md, .html, .mdx, .rst, and .adoc.

Quick Start

Process a Mermaid-containing document with the export tool, e.g.: node ~/.claude/tools/mermaid-renderer/process-document.js <document-path> --verbose