Aby połączyć dwa podgrafy Mermaid w Obsidianie, nadaj każdej grupie jawny identyfikator i połącz te identyfikatory. Na Macu najpierw przetestuj minimalny diagram, a następnie sprawdź, czy problem dotyczy składni, kierunku układu czy różnicy w zainstalowanym rendererze.

Ten przewodnik opisuje widoczne strzałki między grupami w jednym schemacie blokowym. Celem jest wyświetlenie zamierzonego połączenia, wskazanie jego punktów końcowych i wybranie praktycznej alternatywy, gdy renderer nie tworzy wymaganego układu.

Zacznij od minimalnego połączenia między dwiema grupami

Utwórz tymczasową notatkę i wklej cały blok z ogrodzeniem kodu poniżej. Udokumentowana metoda dodawania diagramu w Obsidianie to blok kodu, którego językiem jest mermaid; nie jest potrzebny osobny plik diagramu. Zaawansowana składnia formatowania

```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 obsługuje jawne identyfikatory podgrafów oraz krawędzie prowadzące do podgrafów i wychodzące z nich. Tutaj groupA i groupB identyfikują kontenery; tekst w nawiasach kwadratowych określa ich tytuły. Ostatni wiersz łączy kontenery. Składnia schematów blokowych

Przełącz się na Widok do czytania, aby sprawdzić wynik. W systemie macOS udokumentowany skrót do przełączania między widokiem do czytania a widokiem edycji to Cmd+E. Możesz też wybrać Widok do czytania za pomocą kontrolki widoku na pasku stanu. Aby precyzyjnie edytować źródło, wybierz Tryb źródłowy. Widoki i tryb edycji

Sprawdź trzy rzeczy: czy widoczne są obie grupy, czy widoczne są ich elementy wewnętrzne i czy strzałka łączy granice obu grup. Podczas tej pierwszej kontroli pomiń odstępy i stylizację. Te przykłady odpowiadają składni z pobranej dokumentacji; na potrzeby tego artykułu nie wyrenderowano ich w lokalnej instalacji Obsidiana.

Jeśli minimalny przykład działa, zachowaj tę notatkę jako punkt odniesienia. Porównaj z nią oryginalny diagram, wprowadzając małe zmiany: najpierw definicje grup, potem ich identyfikatory, a na końcu pojedynczy wiersz łączący. Przywracaj pozostałą zawartość dopiero wtedy, gdy podstawowe połączenie będzie widoczne.

Sprawdź, którego renderera używa Twoja wersja Obsidiana

Zapisz wersję zainstalowanej aplikacji, zanim porównasz wyniki z przykładami online. Dokumentacja aktualizacji Obsidiana wskazuje, że wersje aplikacji i instalatora znajdują się w Ustawienia → Ogólne. Wybierz Sprawdź dostępność aktualizacji, a następnie Uruchom ponownie, jeśli aktualizacja będzie dostępna. Zastosuj się także do osobnego powiadomienia o instalatorze. Aktualizowanie Obsidiana

Istnieje istotna granica między wersjami: informacje o wydaniu Obsidiana z 22 października 2026 r. określają wersję Desktop 1.15.0 jako wczesny dostęp i podają, że diagramy używają Pele ze zgodnością składni Mermaid 12.1.0. Te same informacje mówią, że w tym wydaniu Obsidian nie zawiera już samego Mermaid. Instrukcje zakładające, że każda instalacja Obsidiana dołącza Mermaid, zależą od wersji. Obsidian 1.15.0 Desktop (wczesny dostęp)

Te informacje o wydaniu wskazują też, że w wersji 1.15.0 usunięto ustawienie Pokaż diagramy Mermaid w notatkach. Jeśli w Twojej instalacji widzisz to ustawienie albo monit o włączenie, odnotuj tę różnicę zamiast bez końca szukać kontrolki opisanej dla innej wersji. Obsidian 1.15.0 Desktop (wczesny dostęp)

Na potrzeby diagnostyki zapisz krótko: wersję aplikacji, widok edycji lub widok do czytania, dokładny tekst diagramu i zaobserwowany wynik. Opisz wynik konkretnie, na przykład: „widoczne są dwie grupy, ale brakuje strzałki łączącej”. To bardziej przydatne niż sama informacja, że diagram nie działa.

Zdecyduj, czy strzałka ma łączyć grupy, czy elementy

Wybierz punkty końcowe zgodnie z tym, co diagram ma przekazywać. W przypadku ogólnej relacji między grupami zacznij od przykładu z kontenerami. Jeśli chodzi o konkretne przejście między elementami, użyj poniższej, kompletnej alternatywy i oceń ją osobno.

```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
```

Ostatni wiersz łączy teraz nazwane elementy po obu stronach granicy grupy. Dokumentacja schematów blokowych Mermaid rozróżnia węzły, krawędzie i podgrafy; konsekwentnie używaj identyfikatorów zamierzonych punktów końcowych. Składnia schematów blokowych

Jeśli przykład z kontenerami nie działa w zainstalowanym rendererze, ale przykład z elementami działa, ten drugi jest praktycznym rozwiązaniem, gdy relacja między elementami wyraża zamierzone znaczenie. Zachowaj to rozróżnienie w diagramie: nie przedstawiaj przejścia między konkretnymi elementami jako dowodu, że połączone są same kontenery.

Podczas dostosowywania któregokolwiek przykładu wprowadzaj po jednej zmianie. Najpierw zmień widoczne tytuły, sprawdź wynik, a następnie dodaj więcej elementów. Stylizację i zagnieżdżanie zostaw na później. Każda zmiana będzie miała wówczas jasny cel, a łatwiej będzie ustalić, która zmiana jako pierwsza spowodowała błąd.

Zrozum, dlaczego zmienia się kierunek podgrafu

Mermaid opisuje ograniczenie układu: gdy węzeł podgrafu łączy się z czymś poza swoją grupą, własny kierunek podgrafu jest ignorowany i przejmuje on kierunek nadrzędny. Dokumentacja porównuje to z połączeniem z kontenerem. Kierunek w podgrafach

W rezultacie strzałka może być poprawna, mimo że układ różni się od zamierzonego. W pierwszym przykładzie osobno sprawdź wewnętrzne stosy i strzałkę między grupami. W drugim najpierw sprawdź punkty końcowe elementów, a dopiero potem oceń układ. Interpretując oba wyniki, pamiętaj o opisanej wyżej różnicy między rendererami.

Jeśli potrzebujesz zarówno połączenia między konkretnymi elementami, jak i innego kierunku wewnętrznego, potraktuj je jako dwa odrębne wymagania. Udokumentowane ograniczenie Mermaid oznacza, że dodanie lokalnej deklaracji kierunku nie gwarantuje spełnienia obu. Wybierz połączenie, które trafnie wyraża relację, a w razie potrzeby uprość układ.

Praktycznym rozwiązaniem jest zachowanie jednego ogólnego kierunku i skrócenie diagramu, aż śledzenie połączonych elementów stanie się łatwe. Jeśli wystarczy znaczenie na poziomie grup, wróć do pierwszego przykładu. To decyzje redakcyjne dotyczące przekazu diagramu, a nie gwarancja określonych pozycji ani przebiegu strzałek.

Ustal przyczynę błędu przed przebudową diagramu

Skorzystaj z poniższej sekwencji diagnostycznej, aby zdecydować, co sprawdzić dalej. To pomoc w podejmowaniu decyzji, oparta na udokumentowanej składni i różnicach między rendererami, a nie lista potwierdzonych usterek.

Obserwacja Następna kontrola Co zapisać
Notatka wyświetla dosłowny tekst diagramu Sprawdź otwierające i zamykające ogrodzenia kodu, a następnie przełącz się na Widok do czytania Czy blok w ogóle jest renderowany
Minimalny przykład powoduje błąd Porównaj wklejony blok z przykładem znak po znaku Pełną treść błędu
Grupy są renderowane, ale nie ma między nimi połączenia Osobno przetestuj kompletną alternatywę łączącą elementy Który typ punktów końcowych działa
Strzałka jest widoczna, ale zmienia się wewnętrzny kierunek Sprawdź udokumentowane ograniczenie dotyczące kierunku węzła zewnętrznego Czy problemem jest nadal połączenie, czy układ
Przykład działa, dopóki nie zostanie przywrócona dodatkowa zawartość Cofnij ostatni dodatek i powtórz tę pojedynczą zmianę Najmniejszy dodatek powiązany z błędem
Ten sam tekst zachowuje się inaczej w innym środowisku Porównaj wersje aplikacji, renderery i tryby widoku Dokładne środowiska i wyniki

Aby niezależnie porównać składnię, dokumentacja Obsidiana zaleca edytor Mermaid Live Editor. Wklej do niego treść diagramu bez otaczających ją ogrodzeń Markdown. Poprawne renderowanie w przeglądarce jest przydatnym materiałem do porównania, ale nie potwierdza identycznego działania w Twojej wersji Obsidiana. Zaawansowana składnia formatowania

Jeśli wynik nadal różni się w Obsidianie, powtórz minimalny test w testowym skarbcu wersji desktopowej. Oficjalne wskazówki Obsidiana dotyczące rozwiązywania problemów zalecają użycie w aplikacji desktopowej opcji Otwórz Pomoc > Testowy skarbiec, aby odtworzyć problem poza zwykłą konfiguracją skarbca. Zalecają też zaktualizowanie motywów i wtyczek społecznościowych oraz ponowne uruchomienie aplikacji przed dalszą diagnostyką. Informacje o kategorii „Zgłoszenia błędów”

Jeśli test w skarbcu się powiedzie, sprawdzaj różnice w oryginalnym skarbcu pojedynczo. Jeśli problem występuje również tam, zachowaj minimalny przykład, wersje aplikacji i instalatora, tryb widoku oraz dokładny opis zaobserwowanego wyniku. Zanim go zgłosisz, poszukaj na oficjalnym forum podobnego zgłoszenia, zgodnie z zaleceniami Obsidiana. Informacje o kategorii „Zgłoszenia błędów”

Na koniec pozostaw najmniejszy diagram, który przekazuje wymaganą relację. Zachowaj połączenie kontenerów, gdy to grupy mają być punktami końcowymi; użyj połączenia elementów, gdy przejście dotyczy konkretnych elementów. Gdy wybrany wariant będzie zadowalająco renderowany w zainstalowanej wersji Obsidiana, stopniowo przywracaj dodatkowe szczegóły i zakończ, gdy diagram nadal będzie czytelny.

Źródła