# Mermaid To Image

> Рендер Mermaid-диаграмм (.mmd) в PNG/SVG. Скрипт mermaid_to_image.py читает .mmd (файл или stdin) и отдаёт изображение: приоритет локальному mmdc (mermaid-cli), fallback на публичный API mermaid.ink. Поддерживает выбор формата (svg/png), фоновый цвет, масштаб PNG, движок рендера (auto/mmdc/ink), вывод в файл или stdout. Триггеры: 'mermaid в картинку', 'отрендерить диаграмму', '.mmd в png', 'merma…

- **Type:** Skill
- **Install:** `agentstack add skill-bestdeejay-design-agent-skills-mermaid-to-image`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [bestdeejay-design](https://agentstack.voostack.com/s/bestdeejay-design)
- **Installs:** 0
- **Category:** [Developer Tools](https://agentstack.voostack.com/c/developer-tools)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [bestdeejay-design](https://github.com/bestdeejay-design)
- **Source:** https://github.com/bestdeejay-design/agent-skills/tree/main/skills/mermaid-to-image
- **Website:** https://bestdeejay-design.github.io/agent-skills/

## Install

```sh
agentstack add skill-bestdeejay-design-agent-skills-mermaid-to-image
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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

```bash
# Файл → 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.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [bestdeejay-design](https://github.com/bestdeejay-design)
- **Source:** [bestdeejay-design/agent-skills](https://github.com/bestdeejay-design/agent-skills)
- **License:** MIT
- **Homepage:** https://bestdeejay-design.github.io/agent-skills/

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-bestdeejay-design-agent-skills-mermaid-to-image
- Seller: https://agentstack.voostack.com/s/bestdeejay-design
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.