Om du vill koppla ihop två Mermaid-undergrafer i Obsidian tilldelar du varje grupp ett uttryckligt ID och kopplar ihop dessa ID:n. Testa först ett minimalt diagram på din Mac och kontrollera sedan om problemet beror på syntaxen, layoutens riktning eller skillnader i den installerade renderaren.

Den här guiden handlar om synliga pilar mellan grupper i ett flödesschema. Målet är att få den avsedda kopplingen att visas, identifiera dess ändpunkter och välja ett praktiskt alternativ när renderaren inte skapar den layout du behöver.

Börja med en minimal koppling mellan två grupper

Skapa en tillfällig anteckning och klistra in hela kodblocket nedan. Enligt Obsidians dokumentation lägger du till ett diagram med ett kodblock vars språk är mermaid; det behövs ingen separat diagramfil. Avancerad formateringssyntax

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

Mermaids dokumentation beskriver uttryckliga ID:n för undergrafer och kanter till och från undergrafer. Här identifierar groupA och groupB behållarna, medan texten inom hakparenteser anger deras titlar. Den sista raden kopplar ihop behållarna. Syntax för flödesscheman

Växla till Läsvy för att granska resultatet. I macOS är den dokumenterade kortkommandokombinationen för att växla mellan läs- och redigeringsvy Cmd+E. Du kan också välja Läsvy via vyreglaget i statusfältet. Välj Källäge för att redigera källtexten exakt. Vyer och redigeringsläge

Kontrollera tre saker: att båda grupperna visas, att deras interna objekt visas och att en pil kopplar ihop de två gruppgränserna. Bortse från mellanrum och formatering under den första kontrollen. Exemplen följer den dokumentation av syntaxen som hämtades in; de har inte renderats i en lokal Obsidian-installation för den här artikeln.

Om det minimala exemplet fungerar kan du behålla anteckningen som referens. Jämför ditt ursprungliga diagram med den i små steg: först gruppdeklarationerna, sedan deras ID:n och till sist den enda kopplingsraden. Lägg tillbaka resten av innehållet först när grundkopplingen visas.

Kontrollera vilken renderare din Obsidian-version använder

Notera den installerade appversionen innan du jämför resultat med exempel på nätet. Obsidians uppdateringsdokumentation anger att app- och installationsversionerna finns under Inställningar → Allmänt. Välj Sök efter uppdateringar och sedan Starta om om en uppdatering erbjuds. Följ även eventuella separata meddelanden om installationsprogrammet. Uppdatera Obsidian

Det finns en viktig versionsgräns: Obsidians versionsanteckningar från den 22 oktober 2026 anger att Desktop 1.15.0 är en tidig åtkomstversion och att diagram använder Pele, med kompatibilitet för Mermaid 12.1.0-syntax. Samma anteckningar säger att Obsidian inte längre inkluderar Mermaid i den versionen. Utgå från att instruktioner som förutsätter att alla Obsidian-installationer innehåller Mermaid kan vara versionsberoende. Obsidian 1.15.0 för dator (tidig åtkomst)

Versionsanteckningarna tar också bort inställningen Visa Mermaid-diagram i anteckningar i version 1.15.0. Om din installation visar den inställningen eller en uppmaning om att aktivera funktionen ska du notera skillnaden i stället för att fortsätta leta efter en kontroll som beskrivs för en annan version. Obsidian 1.15.0 för dator (tidig åtkomst)

För felsökningen kan du föra en kort jämförelselogg: appversion, redigerings- eller läsvy, exakt diagramtext och observerat resultat. Beskriv resultatet konkret, till exempel: ”Två grupper visas, men kopplingspilen saknas.” Det är mer användbart än att bara notera att diagrammet är trasigt.

Avgör om pilen ska koppla ihop grupper eller objekt

Välj ändpunkter utifrån vad diagrammet ska förmedla. Börja med behållarexemplet för att visa en övergripande relation mellan grupper. Använd det fullständiga alternativet nedan för en viss övergång mellan objekt och bedöm det separat.

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

Den sista raden kopplar nu ihop namngivna objekt på varsin sida om gruppgränsen. Mermaids dokumentation om flödesscheman skiljer mellan noder, kanter och undergrafer. Använd konsekvent ID:n för de avsedda ändpunkterna. Syntax för flödesscheman

Om behållarexemplet inte fungerar i den installerade renderaren, men objekteexemplet gör det, kan det senare vara ett praktiskt alternativ när en koppling mellan objekt uttrycker det du menar. Bevara den skillnaden i diagrammet: visa inte en specifik övergång mellan objekt som bevis för att själva behållarna är sammankopplade.

När du anpassar något av exemplen ska du göra en ändring i taget. Börja med att byta ut de synliga titlarna, granska resultatet och lägg sedan till fler objekt. Vänta med formatering och nästling. Då har varje ändring ett tydligt syfte, och det blir lättare att identifiera vilken ändring som först orsakade ett fel.

Förstå varför riktningen i en undergraf ändras

Mermaids dokumentation beskriver en begränsning i layouten: när en nod i en undergraf kopplas utanför gruppen ignoreras undergrafens egen riktning, som i stället ärver den överordnade riktningen. Dokumentationen jämför detta med en koppling till behållaren. Riktning i undergrafer

Därför kan en pil vara korrekt även om layouten skiljer sig från det du tänkt dig. I det första exemplet granskar du de interna staplarna och pilen mellan grupperna var för sig. I det andra kontrollerar du först ändpunkterna för objekten innan du bedömer layouten. Tänk på skillnaderna mellan renderare som beskrivs ovan när du tolkar resultaten.

Om du behöver både en specifik koppling mellan objekt och en annan intern riktning ska du behandla dem som separata krav. Mermaids dokumenterade begränsning innebär att du inte bör räkna med att en lokal riktningsangivelse uppfyller båda. Välj den koppling som beskriver relationen korrekt och förenkla sedan layouten vid behov.

Ett användbart alternativ är att behålla en gemensam riktning och korta ner diagrammet tills de sammankopplade objekten blir lätta att följa. Om gruppnivån räcker för att uttrycka betydelsen kan du återgå till det första exemplet. Det här är redaktionella val om vad diagrammet förmedlar, inte garantier för exakta positioner eller pilarnas dragning.

Ring in felet innan du bygger om diagrammet

Följ den här felsökningsordningen för att avgöra vad du ska prova härnäst. Den är ett hjälpmedel för beslutsfattande utifrån den dokumenterade syntaxen och skillnaderna mellan renderare, inte en lista över bekräftade fel.

Observation Nästa kontroll Vad du ska notera
Anteckningen visar diagramtexten som vanlig text Kontrollera inledande och avslutande kodstaket och växla sedan till Läsvy Om blocket renderas över huvud taget
Det minimala exemplet ger ett fel Jämför det inklistrade blocket tecken för tecken med exemplet Hela felmeddelandet
Grupperna visas, men inte kopplingen Testa det fullständiga alternativet med koppling mellan objekt separat Vilken typ av ändpunkt som fungerar
Pilen visas, men den interna riktningen ändras Granska den dokumenterade begränsningen för riktning när noder kopplas utanför gruppen Om det fortfarande är kopplingen eller layouten som behöver åtgärdas
Exemplet fungerar tills du lägger tillbaka mer innehåll Ångra det senaste tillägget och upprepa just den ändringen Det minsta tillägget som verkar orsaka felet
Samma text beter sig olika på andra ställen Jämför appversioner, renderare och vyer De exakta miljöerna och resultaten

För en oberoende jämförelse av syntaxen rekommenderar Obsidians dokumentation Mermaids Live Editor. Klistra in diagraminnehållet där utan de omgivande Markdown-kodstaketen. En lyckad rendering i webbläsaren är användbar som jämförelse, men visar inte att resultatet blir identiskt i din Obsidian-version. Avancerad formateringssyntax

Om resultatet fortfarande skiljer sig i Obsidian kan du upprepa minim testet i skrivbordsversionens sandlådevault. Obsidians officiella felsökningsvägledning anger Öppna hjälp > Sandlådevault som sättet att återskapa ett problem i skrivbordsversionen utan den vanliga vaultkonfigurationen. Den rekommenderar också att du uppdaterar communityteman och tillägg och startar om innan du fortsätter felsöka. Om kategorin Buggrapporter

Om sandlådan fungerar kan du undersöka skillnaderna i den ursprungliga vaulten en i taget. Om felet även uppstår där ska du spara det minimala exemplet, app- och installationsversionerna, vyläget och det exakta observerade resultatet. Sök på det officiella forumet efter en befintlig rapport om samma problem innan du rapporterar det, enligt Obsidians rapporteringsvägledning. Om kategorin Buggrapporter

Avsluta med det minsta diagram som kommunicerar den nödvändiga relationen. Behåll en koppling mellan behållare när grupperna är de avsedda ändpunkterna. Använd en koppling mellan objekt när övergången gäller särskilda objekt. När det valet fungerar som det ska i din installerade Obsidian-version kan du gradvis lägga tillbaka detaljer och sluta när diagrammet fortfarande är lättläst.

Källor