Om du vill hålla Mermaid-noder i fasta rader när kopplingarna ändras använder du ett blockdiagram med uttryckliga kolumner där renderaren stöder det. I Obsidian på Mac bör du först kontrollera vilken renderare som är installerad: flödesschemats undergrafer kan inte på ett tillförlitligt sätt framtvinga den här layouten.

Den här guiden fokuserar på en uppgift: att ordna sex neutrala noder i två vågräta rader och samtidigt bevara kopplingarna mellan enskilda noder. Avgör separat om du behöver justerade rutor, räta vinklar på kopplingarna eller båda. Ett resultat som uppfyller det ena kravet kan fortfarande misslyckas med det andra.

Varför stör tvärkopplingar raderna i flödesscheman?

Mermaid dokumenterar en särskild begränsning i flödesscheman: när en nod i en undergraf kopplas till något utanför den undergrafen ignoreras den lokala riktningen, och noden ärver huvudgrafens riktning. Därför kan en rad som deklarerats med direction LR inuti en flowchart TB ändra ordning när en extern koppling läggs till. Se den officiella begränsningen för undergrafers riktning.

Den här fullständiga exempelanteckningen visar det villkoret. De två interna kopplingarna antyder vågräta rader, men A --> D korsar undergrafens gräns:

```mermaid
flowchart TB
  subgraph RowOne[Row One]
    direction LR
    A[Alpha] --> B[Beta]
  end
  subgraph RowTwo[Row Two]
    direction LR
    D[Delta] --> E[Epsilon]
  end
  A --> D
```

Mermaid stöder också kopplingar till undergraf-ID:n. Om du i stället kopplar RowOne till RowTwo kan du undvika att rikta kopplingarna mot deras interna noder, men då ändras kopplingens innebörd: den går mellan grupper i stället för mellan Alpha och Delta. Använd det alternativet endast om grupprelationen stämmer. Osynliga länkar som A ~~~ B dokumenteras som hjälpmedel för positionering, inte som en metod för att låsa rader. Syntax för flödesscheman

För den här uppgiften ska du behålla de enskilda ändpunkterna. Om en obligatorisk nodkoppling ersätts med en gruppkoppling blir diagrammet prydligare, men informationen som det ska förmedla går förlorad.

Kontrollera vilken renderare din Mac faktiskt använder

Öppna Settings i Obsidian, välj General och anteckna appens aktuella version. Enligt den aktuella dokumentationen finns versionsinformationen och kontrollen Read the changelog där. Läs versionsinformationen för den installerade versionen innan du följer instruktioner som gäller en annan version. Inställningar — Obsidian Hjälp

Det finns en viktig versionsgräns: Obsidians tidiga åtkomstversion 1.15.0 för Desktop, daterad 22 oktober 2026, introducerar Pele för diagramrendering och beskriver kompatibilitet med Mermaid 12.1.0-syntax. Det tillkännagivandet fastställer inte vilken renderare en tidigare installerad version använder. Versionsinformation för Obsidian 1.15.0 Desktop

Pele dokumenterar sin egen layoutmotor, med nodpositioner, avstånd och kantbanor som skiljer sig från Mermaids. Kompatibilitetslistan innehåller både block och block-beta. Syntaxkompatibilitet är därför inte i sig tillräckligt belägg för att ett diagram i Obsidian kommer att se ut som en rendering från Mermaid uppströms. Peles kompatibilitet

Mermaid uppströms har också ändrats: i dess layoutdokumentation står det att ELK lades till och blev standard för flödesscheman i version 12.0.0. Tidigare behövde värdprogrammet installera och registrera det separata ELK-paketet. Råd om att välja layout: elk måste därför villkoras utifrån renderare och version. Mermaids layouter

För en användbar jämförelse bör du hålla tre saker samlade: den exakta diagramkällan, Obsidian-versionen och renderingsmiljön. Ändra en sak i taget. Om du jämför olika källtext i olika renderare går det inte att avgöra varför raderna flyttades.

Använd ett blockdiagram för att placera raderna uttryckligen

Mermaids blockdiagram ger författaren kontroll över placeringen genom kolumner. Blocken fyller de deklarerade kolumnerna och fortsätter på efterföljande rader; space reserverar tomma celler. Det här är den Mermaid-metod som stöds för att ordna rutor oberoende av flödesschemats rangordning. Syntax för blockdiagram

Skapa en tillfällig anteckning i Obsidian och klistra in hela blocket nedan, inklusive de inledande och avslutande trippelbackticksen. Enligt Obsidians dokumentation skrivs diagram som kodblock med språkkoden mermaid. Avancerad formateringssyntax — Obsidian Hjälp

```mermaid
block
  columns 5
  A["Alpha"] space B["Beta"] space C["Gamma"]
  space:5
  D["Delta"] space E["Epsilon"] space F["Zeta"]

  A --> B
  B --> C
  D --> E
  E --> F
  A --> D
  B --> E
  C --> F
  A --> F
```

Den avsedda placeringen är Alpha, Beta och Gamma på den övre raden, med Delta, Epsilon och Zeta under dem. Fem kolumner ger två tomma mellanrum; space:5 reserverar en helt tom rad mellan de fyllda raderna. Kopplingarna hänvisar till de deklarerade block-ID:na. Dessa konstruktioner följer Mermaids dokumenterade syntax för kolumner, mellanrum och kanter. Syntax för blockdiagram

Om den installerade renderaren inte godkänner block bör du stanna där och undersöka kompatibiliteten. Kontrollera renderarens dokumenterade syntax innan du provar den äldre stavningen block-beta. Pele listar uttryckligen båda, men det bevisar inte stöd i alla äldre Obsidian-versioner. Exemplen här har kontrollerats mot dokumentationen, men har inte körts i en installerad Obsidian-renderare. Peles kompatibilitet

Utvärdera resultatet i två steg. Kontrollera först de sex etiketterna och vilken rad de är avsedda att tillhöra. Granska sedan alla åtta relationerna, särskilt den diagonala kopplingen mellan Alpha och Zeta. Låt inte ett godtagbart rutmönster dölja en otydlig eller överlappande koppling.

Behöver även rätvinkliga kopplingar ligga i fasta rader?

Behandla kopplingarnas utseende som ett separat godkännandetest. Mermaids konfiguration för flödesscheman definierar curve som en inställning för kantåtergivning och listar step, stepBefore och stepAfter som möjliga värden. Den definierar även nodeSpacing för noder på samma nivå och rankSpacing för noder på olika nivåer. Inställningarna påverkar utseende och mellanrum; deras dokumenterade syften innebär inte att de låser nodernas radtillhörighet. Konfigurationsschema för flödesschemadiagram

Blockexemplet styr placeringen av rutorna. Det garanterar inte att varje tvärkoppling bara använder vågräta och lodräta segment. Anta inte att en inställning för flödesschemats kurvor styr kopplingar i blockdiagram, eller att en inställning som godtas av Mermaid uppströms fungerar identiskt i Pele.

Använd den här beslutshjälpen innan du lägger tid på att justera diagrammet:

Önskat resultat Praktiskt val Godkännandekontroll
Två fasta rader med individuella tvärkopplingar Blockdiagram, om det stöds Alla noder förblir på avsedd rad
Ett lättläst flödesschema med flexibel placering Justeringar av flödesschemats layout och mellanrum Relationerna förblir tydliga efter varje ändring
Kopplingar mellan hela grupper Undergrapsändpunkter, när det är semantiskt korrekt Ändpunkterna beskriver den avsedda relationen
Rutor placerade manuellt i Obsidian Canvas Kortens placering och kopplingar motsvarar det avsedda diagrammet
Fasta rader plus föreskrivna vinklar på kopplingarna Utvärdera kraven separat Granska varje vinkel och korsning i den faktiska renderaren

Vad gör du om den installerade Obsidian-versionen inte kan återge blockdiagrammet?

För en vanlig Mac-uppgift där manuellt placerade kort är godtagbara erbjuder Obsidian Canvas ett dokumenterat alternativ. Öppna kommandopaletten och välj Canvas: Create new canvas. Dubbelklicka på arbetsytan för att skapa textkort och skriv sedan in de sex exempel­etiketterna. Canvas — Obsidian Hjälp

Markera de tre övre korten och välj Align och sedan Arrange in a row. Upprepa för de tre nedre. Justera mellanrummen vid behov. Om du vill koppla ihop korten håller du pekaren över kanten på ett kort tills en fylld cirkel visas. Dra sedan cirkeln till kanten på ett annat kort. Dessa funktioner för ordning och kopplingar är dokumenterade Canvas-funktioner. Canvas — Obsidian Hjälp

Canvas skapar ett separat .canvas-dokument i stället för ett inbäddat Mermaid-kodblock. Välj det när det är godtagbart att placera korten direkt. Dess placeringskontroller passar för raduppgiften, men den citerade dokumentationen bekräftar inte att det går att redigera godtyckliga brytpunkter för kopplingar. Canvas — Obsidian Hjälp

Verifiera resultatet innan du lägger till fler kopplingar

Använd en kort jämförelsesekvens för att skilja syntax som inte stöds från layoutbeteende. Det här är en diagnostisk metod som utgår från de dokumenterade begränsningarna, inte ett påstående om en testad Obsidian-installation:

  1. Återge de sex deklarerade blocken utan de åtta kopplingslinjerna. Kontrollera radernas innehåll.
  2. Lägg tillbaka de fyra kopplingarna inom raderna. Kontrollera etiketterna och pilriktningen.
  3. Lägg tillbaka de tre kopplingarna mellan motsvarande kolumner. Granska utrymmet mellan raderna.
  4. Lägg sist tillbaka A --> F. Kontrollera om dess bana fortfarande är lätt att följa.
  5. Öppna den slutliga källan igen i miljön där den ska läsas. Bedöm den återgivningen.

Om den första återgivningen misslyckas med att tolka syntaxen bör du undersöka diagramstödet innan du ändrar mellanrummen. Om placeringen är bra men en koppling är otydlig bör du åtgärda just den banan eller överväga en annan presentation. Behåll alla obligatoriska relationer synliga när du jämför alternativ. Om du tar bort den besvärliga kopplingen försvinner just det villkor som diagrammet måste hantera.

Börja med uttrycklig placering i blockdiagram och kontrollera resultatet i den installerade renderaren för att få stabila rader. Behåll nodrelationerna, granska kopplingarnas geometri separat och använd Canvas när det är mer praktiskt att placera korten direkt.

Källor