Новости
Обновление услуги LLM: управление API-ключами, моделями и расходами
DF
октября 21, 2025
Обновлено ноября 6, 2025

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

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

Ссылки

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

  • Создание и редактирование диаграмм в Mermaid-синтаксисе
  • Визуальный редактор с поддержкой позиционирования, соединений и цветовых схем
  • Автоматическое сохранение изменений в исходный .mmd файл как комментарии
  • Rust CLI для компиляции .mmd → изображений (PNG, SVG и др.)
  • Веб-интерфейс на React для интерактивного редактирования

Установка

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

  • Полная совместимость с Mermaid
  • Репродуцируемость и контроль версий
  • Возможность точной визуальной настройки
  • Быстрая интеграция в CI/CD для автогенерации диаграмм в документации

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

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

Заключение

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

FAQ

  • Что делает oxdraw лучше обычного Mermaid?
    Обычный Mermaid требует ручного позиционирования элементов через код. oxdraw решает эту проблему, позволяя редактировать диаграмму визуально и автоматически сохранять позиционные изменения обратно в исходный файл как комментарии — без потери совместимости.
  • Можно ли использовать oxdraw без веб-интерфейса?
    Да. CLI-инструмент, написанный на Rust, позволяет компилировать .mmd файлы в изображения без необходимости запускать интерфейс. Это удобно для автоматизации или CI/CD.
  • Где сохраняются изменения после визуального редактирования?
    Все изменения вносятся в исходный .mmd файл в виде комментариев (например %% position: ...). Таким образом, вы можете версионировать и отслеживать различия в Git.
  • Какие форматы экспорта поддерживаются?
    С помощью CLI можно экспортировать диаграммы в SVG, PNG или PDF, что делает oxdraw подходящим для технической документации и презентаций.
  • Можно ли интегрировать oxdraw в существующие проекты?
    Да. oxdraw полностью совместим с Mermaid, поэтому вы можете использовать его в текущих проектах, не меняя формат диаграмм.
Оценка:
5 из 5
Аverage rating : 5
Оценок: 1
191028 Санкт-Петербург Литейный пр., д. 26, Лит. А
+7 (812) 403-06-99
700 300
ООО «ИТГЛОБАЛКОМ ЛАБС»
700 300

Вам также может быть интересно...