☰
06.11.2025

Как использовать oxdraw: визуальный редактор Mermaid-диаграмм с CLI и поддержкой Rust

oxdraw — это инструмент для создания и редактирования диаграмм с использованием декларативного синтаксиса и возможностью визуального редактирования через веб-интерфейс. Он основан на Mermaid, но позволяет не просто писать код диаграмм, а также настраивать внешний вид (позиции, цвета, линии, стили) прямо в интерфейсе, при этом все изменения автоматически сохраняются обратно в исходный .mmd-файл в виде комментариев.
Благодаря этому диаграммы остаются детерминированными, версионируемыми и совместимыми с другими Mermaid-инструментами.

Ссылки

Возможности oxdraw

Установка

1. Клонирование репозитория

git clone https://github.com/RohanAdwankar/oxdraw.git
cd oxdraw

2. Установка зависимостей

Rust (для CLI)

Убедитесь, что Rust установлен. Если нет:

curl https://sh.rustup.rs -sSf | sh

Соберите CLI:

cargo build --release

Node.js (для веб-интерфейса)

Установите зависимости фронтенда:

cd web
npm install

Использование

1. Создание диаграммы

Создайте Mermaid-файл:

echo "graph TD; A-->B; B-->C;" > example.mmd

2. Запуск веб-интерфейса

npm run dev

Откройте в браузере:
http://localhost:5173

Загрузите example.mmd и начните редактирование — вы можете перемещать узлы, менять цвета, стили и связи.
Все изменения автоматически сохраняются в комментариях в файле, например:

graph TD
A-->B
B-->C
%% position: A(100,200), B(200,300)

Компиляция диаграмм

После редактирования можно сгенерировать изображения:

cargo run --release -- example.mmd --output diagram.svg

Поддерживаются форматы: SVG, PNG и PDF.

Преимущества oxdraw

Пример сценария использования

  1. Создайте архитектурную схему системы в Mermaid
  2. Откройте её в oxdraw и визуально расставьте блоки
  3. Сохраните файл и добавьте в Git
  4. С помощью CLI сгенерируйте финальные изображения для документации
Запустите проект за минуты с VPS в России — предустановленное ПО, высокая производительность и надёжная инфраструктура Serverspace - Арендовать VPS

Заключение

oxdraw - это инструмент, который объединяет удобство визуального редактирования с гибкостью декларативного подхода. Он особенно полезен для инженеров, DevOps и технических писателей, которые хотят документировать инфраструктуру, архитектуру систем или CI/CD-пайплайны в виде наглядных и воспроизводимых диаграмм.
С помощью oxdraw вы можете одновременно использовать силу Mermaid и простоту drag-and-drop интерфейса, не теряя контроль над кодом и совместимость с другими инструментами.
Если вы цените детерминизм, прозрачность и контроль версий, oxdraw станет отличным дополнением к вашему инструментарию.

FAQ