Чтобы соединить два подграфа Mermaid в Obsidian, задайте каждой группе явный идентификатор и соедините эти идентификаторы. На Mac сначала проверьте простую диаграмму, а затем выясните, связана ли проблема с синтаксисом, направлением расположения или отличиями установленного средства визуализации.

В этом руководстве рассматриваются видимые стрелки между группами в одной блок-схеме. Задача состоит в том, чтобы добиться отображения нужной связи, определить её конечные точки и выбрать практичную альтернативу, если средство визуализации не формирует требуемое расположение.

Начните с простой связи между двумя группами

Создайте временную заметку и вставьте приведённый ниже блок целиком, включая ограждения. Согласно документации Obsidian, диаграмма добавляется с помощью блока кода с языком mermaid; отдельный файл диаграммы не нужен. Синтаксис расширенного форматирования

```mermaid
flowchart LR
    subgraph groupA [Group A]
        direction TB
        A1[Item A1] --> A2[Item A2]
    end
    subgraph groupB [Group B]
        direction TB
        B1[Item B1] --> B2[Item B2]
    end
    groupA --> groupB
```

В документации Mermaid описаны явные идентификаторы подграфов и связи с подграфами. Здесь groupA и groupB обозначают контейнеры, а текст в квадратных скобках задаёт их названия. Последняя строка соединяет контейнеры. Синтаксис блок-схем

Переключитесь в Reading view, чтобы проверить результат. В документации для macOS указано сочетание Cmd+E для переключения между режимами чтения и редактирования. Также можно выбрать Reading view с помощью переключателя вида в строке состояния. Для точного редактирования исходного текста выберите Source mode. Режимы просмотра и редактирования

Проверьте три условия: отображаются обе группы, видны их внутренние элементы и стрелка соединяет границы групп. На этом первом этапе не учитывайте интервалы и стили. Примеры соответствуют найденной документации по синтаксису; для этой статьи они не проверялись в локально установленной версии Obsidian.

Если простой пример работает, оставьте эту заметку как образец. Сравнивайте исходную диаграмму с ним небольшими шагами: сначала объявления групп, затем их идентификаторы и, наконец, единственную строку соединения. Возвращайте дополнительное содержимое только после того, как базовая связь отобразится.

Проверьте, какое средство визуализации использует ваша версия Obsidian

Перед сравнением с примерами из интернета запишите версию установленного приложения. В документации Obsidian по обновлению указано, что версии приложения и установщика находятся в Settings → General. Выберите Check for updates, а затем Relaunch, если предлагается обновление. Также установите обновление установщика, если появится отдельное уведомление. Обновление Obsidian

Есть важная граница между версиями: в примечаниях к выпуску от 22 октября 2026 года указано, что Desktop 1.15.0 — это версия раннего доступа, в которой для диаграмм используется Pele с совместимостью с синтаксисом Mermaid 12.1.0. В тех же примечаниях сказано, что в этом выпуске Obsidian больше не включает сам Mermaid. Считайте инструкции, исходящие из того, что Mermaid входит в каждую установку Obsidian, зависящими от версии. Obsidian 1.15.0 Desktop (ранний доступ)

В примечаниях к выпуску также указано, что в версии 1.15.0 удалена настройка Show Mermaid diagrams in notes. Если в вашей установке отображается эта настройка или запрос на включение, зафиксируйте это отличие вместо того, чтобы бесконечно искать элемент управления, описанный для другой версии. Obsidian 1.15.0 Desktop (ранний доступ)

Для диагностики ведите краткую запись: версия приложения, режим редактирования или чтения, точный текст диаграммы и наблюдаемый результат. Описывайте результат конкретно — например: «Две группы отображаются, но соединительная стрелка отсутствует». Это полезнее, чем просто отметить, что диаграмма не работает.

Решите, должна ли стрелка соединять группы или элементы

Выберите конечные точки в соответствии с тем, что должна показывать диаграмма. Для общей связи между группами начните с примера с контейнерами. Для конкретного перехода между элементами отдельно проверьте следующую полную альтернативу.

```mermaid
flowchart LR
    subgraph groupA [Group A]
        A1[Item A1] --> A2[Item A2]
    end
    subgraph groupB [Group B]
        B1[Item B1] --> B2[Item B2]
    end
    A2 --> B1
```

Теперь последняя строка соединяет именованные элементы по разные стороны границы группы. В документации Mermaid по блок-схемам отдельно рассматриваются узлы, связи и подграфы; последовательно используйте идентификаторы нужных конечных точек. Синтаксис блок-схем

Если пример с контейнерами не работает в установленном средстве визуализации, а пример с элементами работает, используйте второй как практичный запасной вариант, если связь между конкретными элементами точно выражает нужный смысл. Сохраните это различие в диаграмме: не представляйте переход между отдельными элементами как свидетельство связи самих контейнеров.

При изменении любого из примеров вносите по одному изменению за раз. Сначала переименуйте видимые заголовки и проверьте результат, затем добавьте другие элементы. Стилизацию и вложенные группы оставьте на потом. Так у каждого изменения будет понятная цель, а причину первого сбоя будет легче определить.

Разберитесь, почему меняется направление подграфа

В документации Mermaid описано ограничение расположения: если узел подграфа соединяется с элементом за пределами своей группы, собственное направление подграфа игнорируется, и он наследует направление родительского графа. В документации это сравнивается со связью с контейнером. Направление в подграфах

Поэтому стрелка может отображаться правильно, даже если расположение не соответствует вашим ожиданиям. В первом примере проверяйте отдельно внутренние последовательности элементов и стрелку между группами. Во втором сначала убедитесь, что конечные точки — нужные элементы, и лишь затем оценивайте расположение. При оценке обоих результатов учитывайте описанные выше различия между средствами визуализации.

Если вам нужна и конкретная связь между элементами, и другое внутреннее направление, считайте их двумя отдельными требованиями. Из-за задокументированного ограничения Mermaid нельзя обещать, что локальное указание направления удовлетворит обоим требованиям. Выберите связь, которая точно выражает нужное отношение, а затем при необходимости упростите расположение.

Практичный запасной вариант — сохранить общее направление и сократить диаграмму, чтобы соединённые элементы было легко проследить. Если достаточно смысла на уровне групп, вернитесь к первому примеру. Это решения о том, что именно передаёт диаграмма, а не гарантия конкретного расположения элементов или маршрута стрелок.

Локализуйте сбой, прежде чем перестраивать диаграмму

Используйте эту последовательность диагностики, чтобы решить, что проверять дальше. Это вспомогательная схема принятия решений, основанная на документированном синтаксисе и различиях между средствами визуализации, а не перечень подтверждённых неисправностей.

Наблюдение Следующая проверка Что записать
В заметке отображается буквальный текст диаграммы Проверьте открывающее и закрывающее ограждения блока кода, затем переключитесь в Reading view Отображается ли блок вообще
При использовании простого примера возникает ошибка Посимвольно сравните вставленный блок с примером Полный текст ошибки
Группы отображаются, но связь между ними — нет Отдельно проверьте полную альтернативу со связью между элементами Связь какого типа работает
Стрелка отображается, но внутреннее направление меняется Проверьте задокументированное ограничение направления для узлов, выходящих за пределы группы Осталась ли проблема со связностью или с расположением
Пример работает, пока не будет добавлено больше содержимого Отмените последнее добавление и повторите только это изменение Какое минимальное добавление связано со сбоем
Один и тот же текст ведёт себя по-разному в другом месте Сравните версии приложения, средства визуализации и режимы просмотра Точные среды и результаты

Для независимой проверки синтаксиса документация Obsidian рекомендует Mermaid Live Editor. Вставьте туда содержимое диаграммы без окружающих ограждений Markdown. Успешное отображение в браузере полезно для сравнения, но не доказывает, что ваша версия Obsidian будет вести себя так же. Синтаксис расширенного форматирования

Если результат в Obsidian по-прежнему отличается, повторите простой тест в настольном хранилище Sandbox. В официальном руководстве Obsidian по устранению неполадок указано, что на компьютере можно выбрать Open Help > Sandbox Vault, чтобы воспроизвести проблему вне обычной конфигурации хранилища. Там также рекомендуется обновить сторонние темы и плагины и перезапустить приложение, прежде чем продолжать диагностику. О категории отчётов об ошибках

Если в Sandbox всё работает, проверяйте отличия исходного хранилища по одному. Если сбой повторяется и там, сохраните простой пример, версии приложения и установщика, режим просмотра и точное описание результата. Перед отправкой отчёта поищите на официальном форуме совпадающее сообщение — это предусмотрено рекомендациями Obsidian по отправке отчётов. О категории отчётов об ошибках

В завершение оставьте самую простую диаграмму, которая передаёт нужную связь. Если предполагаемые конечные точки — группы, соедините контейнеры; если переход относится к определённым элементам, соедините элементы. Когда выбранный вариант приемлемо отображается в установленной версии Obsidian, постепенно возвращайте детали и остановитесь, пока диаграмма остаётся понятной.

Источники