bestdeejay-design Mermaid To Image
Рендер Mermaid-диаграмм из текста
.mmdв файлы PNG/SVG.
Загружай этот скилл когда нужно превратить Mermaid-диаграмму в картинку: для README, документации, презентаций, бейджей или вложений в отчёты.
🎯 When to use
Use this skill when:
- Есть
.mmd-файл или текст Mermaid и нужен PNG/SVG-файл - Нужно вставить диаграмму в README/вики/презентацию (у рендер-плагинов GitHub нет PNG)
- Просят «отрендерить диаграмму», «mermaid в png», «схему в картинку»
- Нужна статичная картинка для экспорта (не интерактивная mermaid.live)
Do NOT use when:
- Диаграмма нужна только в Markdown-исходнике — GitHub рендерит Mermaid сам
- Нужны диаграммы из текстового описания без Mermaid-кода — это
diagram-maker - Нужны диаграммы архитектуры AWS/GCP — отдельный рендер в roadmap
📦 Files
SKILL.md— этот файлscripts/mermaid_to_image.py— рендерер .mmd → PNG/SVG (Python 3 stdlib)
🧰 Usage
# Файл → SVG (по умолчанию):
python3 skills/mermaid-to-image/scripts/mermaid_to_image.py -i diagram.mmd -o diagram.svg
# Файл → PNG:
python3 skills/mermaid-to-image/scripts/mermaid_to_image.py -i diagram.mmd -o diagram.png
# Из stdin (текст прямо в пайплайне):
cat diagram.mmd | python3 mermaid_to_image.py --stdin -o out.svg
# С фоном и масштабом:
python3 mermaid_to_image.py -i d.mmd -o d.png --bg white --scale 3
# В stdout (для программного использования):
python3 mermaid_to_image.py -i d.mmd --stdout > d.svg
🧭 Движки рендера
| Движок | Как включить | Когда выбирать |
|---|---|---|
mmdc (mermaid-cli) |
--engine mmdc (npm i -g @mermaid-js/mermaid-cli) |
офлайн, приватные схемы, большие диаграммы, точный контроль |
ink (mermaid.ink) |
--engine ink |
без установки, быстрый старт; PNG отдаётся как JPEG-образ |
По умолчанию --engine auto: используется mmdc, если он установлен, иначе ink.
🔬 Проверка результата
- SVG: файл начинается с
<svg, валиден для вставки в Markdown/HTML. - PNG:
file out.pngпоказывает «JPEG image data» — это нормально для mermaid.ink (API отдаёт JPEG-кодированный образ); визуально проверьте открытием. - При ошибке сети/API скрипт пишет причину в stderr и завершается с кодом 2.