Mermaid CLI
Mermaid CLI обрабатывает диаграммы внутри Markdown: создает SVG и заменяет текстовые блоки ссылками на готовые изображения.
- 5 158 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- CLI запускает рендерер и записывает изображения или преобразованный Markdown; удаленные наборы иконок могут загружаться по указанным URL.
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/mermaid-cliОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- CLI запускает рендерер и записывает изображения или преобразованный Markdown; удаленные наборы иконок могут загружаться по указанным URL.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Mermaid CLI читает определение диаграммы и создает изображение или PDF. Агент может написать схему в текстовом файле, вызвать команду `mmdc` и проверить готовый результат перед включением в документацию. Тема, фон и часть параметров оформления задаются при запуске. Есть базовая обработка Mermaid-блоков внутри Markdown: программа создает SVG и заменяет блоки ссылками в выходном документе. Текстовый исходник можно хранить в Git и повторять рендер после изменения схемы, не перерисовывая ее вручную.
Для кого. Техническим писателям, которые ведут схемы архитектуры и последовательностей в текстовом виде рядом с документацией.
Подходит, если
- Агент закончил текстовую схему Mermaid, и вы сохраняете ее изображением для документации.
- Техписатель применяет одну тему к нескольким диаграммам проекта.
- Читатель открывает Markdown в программе без поддержки Mermaid; схемы заранее преобразуют в SVG.
- После изменения исходников CI пересоздает изображения диаграмм.
Не подходит, если
- Нужен редактор с ручным перемещением каждого объекта на холсте.
- В окружении нельзя запустить браузерный рендерер.
- Вы ожидаете точный размер PNG для любого типа диаграммы без проверки.
Пример запроса к агенту
Сохрани эту Mermaid-схему как SVG в отдельный каталог и проверь, что подписи не обрезаны.Ограничения
Текущий манифест требует Node.js 22.13 или новее; сверяйте требования выбранного выпуска перед установкой. Для рендера используется браузерное окружение, поэтому на сервере могут понадобиться дополнительные системные зависимости. Параметр размера работает не одинаково для всех типов диаграмм, готовый файл нужно проверить. При преобразовании Markdown программа записывает новый документ и SVG рядом с ним; выберите отдельный выходной путь, чтобы не потерять исходные блоки.
Как отключить. Уберите mmdc из сценария сборки и остановите рендер. Исходные Mermaid-файлы и созданные изображения останутся отдельно.
Частые вопросы
Как получить SVG?
Используйте `mmdc -i input.mmd -o output.svg`, заменив имена файлов своими. Команда прочитает текстовую схему и запишет SVG по выходному пути.
Можно ли сделать прозрачный PNG?
Да. В примере CLI используется `-b transparent` вместе с выходным PNG.
Как увидеть доступные флаги?
Запустите `mmdc -h`.
Подходит ли старый пакет Homebrew?
Автор больше не поддерживает этот метод, он может давать старую версию. Используйте основной npm-путь.
Можно ли передать схему через stdin?
Да. Параметр `--input -` читает схему из стандартного ввода вместо файла. Так можно передать текст от предыдущей команды.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыMCP-сервер для генерации mermaid-диаграмм и графиков с проверкой синтаксиса и экспортом в svg, png и файл
Скилл рисует проверенные схемы архитектуры, процессов, последовательностей и потоков данных в один интерактивный HTML-файл
Marp CLI пересобирает слайды при сохранении Markdown или темы: автор просматривает результат, пока правит текст.
Официальный MCP-сервер draw.io: агент строит диаграммы из XML или Mermaid и открывает их в редакторе draw.io
Markdy
markdy-com
Анимированные диаграммы как код: текст превращается в пошаговое объяснение архитектуры. Библиотека, CLI и сервер MCP, вывод в HTML
Smart Drawio
Smart Drawio Next
MCP-сервер и скилл для редактируемых диаграмм draw.io: агент создает XML по описанию, проверяет связи, чинит теги и применяет темы
Коротко о README
CLI поддерживает собственный CSS и наборы иконок. Ограничения политики сайта могут влиять на встроенные стили готового SVG.