Een .mmd-bestand openen

Wat je ziet

No diagram type detected matching given configuration for text: ```mermaid

Waarom

Je hebt het diagram uit een Markdown-bestand of uit een chat gekopieerd en de afbakening meegenomen. Drie backticks zijn Markdown en geen Mermaid, dus de parser bereikt het diagram nooit.

Oplossing

Haal de openingsregel ```mermaid en de sluitregel ``` weg. Het bestand moet met een diagramsleutelwoord beginnen.

```mermaid
flowchart TD
    A[Start] --> B[Einde]
```

flowchart TD
    A[Start] --> B[Einde]

Wat je ziet

Parse error, de melding eindigt op: got 'PS'

De fout eindigt op: got 'PS'

Waarom

Een openend rond haakje binnen een knooplabel. In Mermaid zijn ronde haakjes vormsyntaxis — A(tekst) is een afgeronde knoop — dus een kaal haakje binnen rechte haken wordt gelezen als het begin van een vorm.

Oplossing

Zet het label tussen aanhalingstekens. Alles daarbinnen wordt als tekst behandeld, haakjes inbegrepen.

flowchart TD
    A[Roep incasseer(bestelling) aan] --> B[Einde]

flowchart TD
    A["Roep incasseer(bestelling) aan"] --> B[Einde]

Wat je ziet

Parse error op de regel waar je de knoop een naam gaf

Waarom

De knoop-id bevat een spatie. In het Nederlands komt dat vooral uit los geschreven samenstellingen: «authenticatie dienst» in plaats van «authenticatiedienst». De id is het token vóór de pijl, en de spatie kapt hem af zodat er een woord overblijft dat nergens heen kan.

Oplossing

Geef de knoop een id van één woord en zet de leesbare tekst in het label. Samenstellingen aaneen schrijven lost het meteen op — en dat is toch al de juiste spelling.

flowchart TD
    authenticatie dienst --> gebruikers database

flowchart TD
    auth[Authenticatiedienst] --> db[Gebruikersdatabase]

Wat je ziet

Parse error, de melding eindigt op: got 'STR'

De fout eindigt op: got 'STR'

Waarom

Een recht dubbel aanhalingsteken binnen een knooplabel. De parser ziet het aan voor het begin van een string en komt daarna de rechte haak van het label tegen waar hij het sluitende aanhalingsteken verwachtte.

Oplossing

Zet het hele label tussen rechte aanhalingstekens en gebruik daarbinnen enkele aanhalingstekens, of schrijf het teken als HTML-entiteit #quot;.

flowchart TD
    A[Hij zei "akkoord"] --> B[Einde]

flowchart TD
    A["Hij zei 'akkoord'"] --> B[Einde]

Wat je ziet

Parse error, de melding eindigt op: got 'end'

De fout eindigt op: got 'end'

Waarom

Je hebt end als knoop-id gebruikt. Kleingeschreven end sluit een subgrafiek af, dus de parser ziet een blokeinde waar hij een knoop verwachtte. Het komt vaak voor: wie Engelse voorbeelden volgt noemt de laatste knoop end, ook als de rest Nederlands is.

Oplossing

Schrijf het met een hoofdletter of geef de knoop een andere id en verplaats het woord naar het label. `Einde` geeft geen problemen.

flowchart TD
    A[Start] --> end

flowchart TD
    A[Start] --> Einde[Afgerond]

Wat je ziet

Het tekent, maar in een toestandsdiagram is één toestand meerdere vakjes geworden

Waarom

Een spatie in de toestands-id. Anders dan een stroomdiagram protesteert een toestandsdiagram niet: het maakt voor elk woord een apart vakje en tekent dat zonder met de ogen te knipperen. Gemeten — `[*] --> Wacht op betaling` levert drie toestanden op, `Wacht`, `op` en `betaling`, waarvan alleen de eerste aan de pijl hangt. In het Nederlands past bijna geen toestandsnaam in één woord, dus het gebeurt voortdurend en er is geen enkel signaal.

Oplossing

Declareer de toestand met `state "Label" as id` en verwijs er alleen via de id naar.

stateDiagram-v2
    [*] --> Wacht op betaling
    Wacht op betaling --> Gesloten

stateDiagram-v2
    state "Wacht op betaling" as wachtBetaling
    [*] --> wachtBetaling
    wachtBetaling --> Gesloten

Wat je ziet

Het tekent, maar het ER-diagram heeft entiteiten die je niet geschreven hebt

Waarom

Het relatielabel bevat een spatie en heeft geen aanhalingstekens. Dit is de valkuil die in het Nederlands het meeste dwarszit, want onze relatiewerkwoorden nemen een voorzetsel: «hoort bij», «komt voor in». Mermaid meldt geen fout: het kapt het label af bij de eerste spatie en maakt van elk overgebleven woord een lege entiteit.

Oplossing

Zet elk relatielabel met een spatie tussen aanhalingstekens. In het Nederlands praktisch allemaal.

erDiagram
    KLANT ||--o{ BESTELLING : hoort bij

erDiagram
    KLANT ||--o{ BESTELLING : "hoort bij"

Wat je ziet

No diagram type detected matching given configuration for text: sequencediagram

Waarom

Het diagramsleutelwoord is verkeerd gespeld of heeft verkeerde hoofdletters. Mermaid is hoofdlettergevoelig: sequenceDiagram werkt, sequencediagram niet. Hetzelfde geldt voor stateDiagram-v2 en erDiagram.

Oplossing

Corrigeer de hoofdletters. Merk op dat graph nog steeds geaccepteerd wordt als oude alias van flowchart, dus die verouderde syntaxis is niet jouw probleem.

sequencediagram
    Client->>API: Hallo

sequenceDiagram
    Client->>API: Hallo

Wat je ziet

Parse error in het pijllabel tussen de strepen

Waarom

Haakjes binnen een pijllabel. Het label |...| heeft dezelfde beperking als een knooplabel: ook daar zijn haakjes syntaxis en geen tekst.

Oplossing

Zet het pijllabel tussen aanhalingstekens.

flowchart TD
    A -->|ja (altijd)| B

flowchart TD
    A -->|"ja (altijd)"| B

Wat je ziet

Parse error die naar de laatste regel van het diagram wijst

Waarom

Een blok dat geopend is en nooit gesloten: alt, opt, loop, par en subgraph willen elk hun eigen end. Mermaid meldt de fout waar de invoer op is, dus het regelnummer wijst naar het einde van het bestand en niet naar het openstaande blok.

Oplossing

Tel de geopende blokken en de end's die je geschreven hebt. Wijst de fout naar de laatste regel, dan is dit het bijna altijd.

sequenceDiagram
    Client->>API: Verzoek
    alt Alles in orde
        API-->>Client: OK

sequenceDiagram
    Client->>API: Verzoek
    alt Alles in orde
        API-->>Client: OK
    end

Wat je ziet

Lexical error on line 1. Unrecognized text.

Waarom

Een ongeldige richting na het diagramsleutelwoord. Stroomdiagrammen accepteren TB, TD, BT, LR en RL, en verder niets; een tikfout sneuvelt in de lexicale analyse voordat er ook maar één knoop gelezen is.

Oplossing

Gebruik een van de vijf geldige richtingen. TD en LR dekken vrijwel alle gevallen.

flowchart XY
    A --> B

flowchart TD
    A --> B

Wat je ziet

Hier tekent het, op GitLab, Confluence of een oud gereedschap niet

Waarom

Een versieverschil. Deze viewer draait op Mermaid 11.12.2; GitLab.com documenteert versie 10, en zelf gehoste wiki's kunnen jaren achterlopen. Syntaxis die na de versie van het andere gereedschap is ingevoerd, wordt hier ontleed en valt daar om.

Oplossing

Vraag de andere motor naar zijn versie. Één woord info in een diagram zetten laat Mermaid zijn eigen versienummer tekenen, wat sneller is dan de changelog doorlezen.

info