Jak otworzyć plik .mmd

Co widzisz

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

Dlaczego

Skopiowałeś diagram z pliku Markdown albo z czatu i zabrałeś ze sobą ogrodzenie. Trzy grawisy to Markdown, a nie Mermaid, więc parser nigdy nie dociera do diagramu.

Rozwiązanie

Usuń wiersz otwierający ```mermaid i zamykający ```. Plik musi zaczynać się słowem kluczowym diagramu.

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

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

Co widzisz

Parse error, komunikat kończy się na: got 'PS'

Błąd kończy się na: got 'PS'

Dlaczego

Otwierający nawias okrągły wewnątrz etykiety węzła. W Mermaidzie nawiasy okrągłe są składnią kształtu — A(tekst) to węzeł zaokrąglony — więc goły nawias w kwadratowych czytany jest jako początek kształtu.

Rozwiązanie

Weź etykietę w cudzysłów. Wszystko w cudzysłowach traktowane jest jako tekst, łącznie z nawiasami.

flowchart TD
    A[Wywołaj obciąż(zamówienie)] --> B[Koniec]

flowchart TD
    A["Wywołaj obciąż(zamówienie)"] --> B[Koniec]

Co widzisz

Parse error w wierszu, w którym nazwałeś węzeł

Dlaczego

Identyfikator węzła zawiera spację. Po polsku to najłatwiejszy do popełnienia błąd, bo naturalne nazwy są wielowyrazowe: «usługa uwierzytelniania», «baza danych». Identyfikator to token przed strzałką, a spacja go ucina, zostawiając wyraz, którego nie ma gdzie umieścić.

Rozwiązanie

Nadaj węzłowi jednowyrazowy identyfikator, a czytelny tekst umieść w etykiecie. Polskie znaki w identyfikatorze działają; psuje wyłącznie spacja.

flowchart TD
    serwer uwierzytelniania --> baza danych

flowchart TD
    auth[Serwer uwierzytelniania] --> db[Baza danych]

Co widzisz

Parse error, komunikat kończy się na: got 'STR'

Błąd kończy się na: got 'STR'

Dlaczego

Cudzysłów prosty wewnątrz etykiety węzła. Parser bierze go za początek napisu, a potem trafia na nawias kwadratowy etykiety tam, gdzie oczekiwał domykającego cudzysłowu.

Rozwiązanie

Opakuj całą etykietę w cudzysłowy proste, a wewnątrz użyj cudzysłowów polskich albo zapisz znak jako encję HTML #quot;.

flowchart TD
    A[Powiedział "cześć"] --> B[Koniec]

flowchart TD
    A["Powiedział „cześć”"] --> B[Koniec]

Co widzisz

Parse error, komunikat kończy się na: got 'end'

Błąd kończy się na: got 'end'

Dlaczego

Użyłeś end jako identyfikatora węzła. Małymi literami end zamyka podgraf, więc parser widzi koniec bloku tam, gdzie oczekiwał węzła. Zdarza się często: idąc za angielskimi przykładami, ostatni węzeł nazywa się end, choć reszta jest po polsku.

Rozwiązanie

Napisz wielką literą albo daj węzłowi inny identyfikator, a słowo przenieś do etykiety. `Koniec` nie sprawia kłopotu.

flowchart TD
    A[Start] --> end

flowchart TD
    A[Start] --> Koniec[Zakończone]

Co widzisz

Rysuje się, ale w diagramie stanów jeden stan rozpadł się na dwa

Dlaczego

Spacja w identyfikatorze stanu. Inaczej niż schemat blokowy, diagram stanów nie protestuje: tworzy osobne pudełko dla każdego wyrazu i rysuje to bez mrugnięcia. Zmierzone — `[*] --> Oczekuje na płatność` daje trzy stany, `Oczekuje`, `na` i `płatność`, z których tylko pierwszy wisi na strzałce. Po polsku prawie żadna nazwa stanu nie mieści się w jednym wyrazie, więc błąd zdarza się stale, a sygnału o nim nie ma żadnego.

Rozwiązanie

Zadeklaruj stan przez `state "Etykieta" as id` i odwołuj się do niego wyłącznie identyfikatorem.

stateDiagram-v2
    [*] --> Oczekuje na płatność
    Oczekuje na płatność --> Zamknięte

stateDiagram-v2
    state "Oczekuje na płatność" as oczekuje
    [*] --> oczekuje
    oczekuje --> Zamknięte

Co widzisz

Rysuje się, ale diagram ER ma encje, których nie napisałeś

Dlaczego

Etykieta relacji zawiera spację i nie ma cudzysłowów. To pułapka, która po polsku przeszkadza najbardziej, bo nasze zwroty relacyjne są wielowyrazowe: «należy do», «występuje w». Mermaid nie zgłasza błędu: ucina etykietę na pierwszej spacji, a każdy pozostały wyraz zamienia w pustą encję.

Rozwiązanie

Bierz w cudzysłów każdą etykietę relacji zawierającą spację. Po polsku praktycznie każdą.

erDiagram
    KLIENT ||--o{ ZAMOWIENIE : należy do

erDiagram
    KLIENT ||--o{ ZAMOWIENIE : "należy do"

Co widzisz

No diagram type detected matching given configuration for text: sequencediagram

Dlaczego

Słowo kluczowe diagramu jest źle zapisane albo ma złą wielkość liter. Słowa kluczowe Mermaida rozróżniają wielkość liter: sequenceDiagram działa, sequencediagram nie. To samo dotyczy stateDiagram-v2 i erDiagram.

Rozwiązanie

Popraw wielkość liter. Zauważ, że graph nadal jest przyjmowany jako dawny alias flowchart, więc ta stara składnia nie jest twoim problemem.

sequencediagram
    Klient->>API: Cześć

sequenceDiagram
    Klient->>API: Cześć

Co widzisz

Parse error w etykiecie krawędzi między kreskami

Dlaczego

Nawiasy wewnątrz etykiety krawędzi. Etykieta |...| ma to samo ograniczenie co etykieta węzła: tam też nawiasy są składnią, a nie tekstem.

Rozwiązanie

Weź etykietę krawędzi w cudzysłów.

flowchart TD
    A -->|tak (zawsze)| B

flowchart TD
    A -->|"tak (zawsze)"| B

Co widzisz

Parse error wskazujący ostatni wiersz diagramu

Dlaczego

Blok otwarty i nigdy niezamknięty: alt, opt, loop, par i subgraph wymagają swojego end. Mermaid zgłasza błąd tam, gdzie kończy mu się wejście, więc numer wiersza wskazuje koniec pliku, a nie niezamknięty blok.

Rozwiązanie

Policz otwarte bloki i napisane end. Gdy błąd wskazuje ostatni wiersz, to prawie zawsze to.

sequenceDiagram
    Klient->>API: Żądanie
    alt Wszystko dobrze
        API-->>Klient: OK

sequenceDiagram
    Klient->>API: Żądanie
    alt Wszystko dobrze
        API-->>Klient: OK
    end

Co widzisz

Lexical error on line 1. Unrecognized text.

Dlaczego

Nieprawidłowy kierunek po słowie kluczowym diagramu. Schematy blokowe przyjmują TB, TD, BT, LR i RL, i nic więcej; literówka przewraca się na analizie leksykalnej, zanim przeczytany zostanie choćby jeden węzeł.

Rozwiązanie

Użyj jednego z pięciu poprawnych kierunków. TD i LR pokrywają prawie wszystkie przypadki.

flowchart XY
    A --> B

flowchart TD
    A --> B

Co widzisz

Tutaj się rysuje, a w GitLabie, Confluence albo starym narzędziu nie

Dlaczego

Różnica wersji. Ta przeglądarka działa na Mermaidzie 11.12.2; GitLab.com dokumentuje wersję 10, a wiki utrzymywane samodzielnie bywają opóźnione o lata. Składnia wprowadzona po wersji drugiego narzędzia parsuje się tutaj, a przewraca tam.

Rozwiązanie

Zapytaj drugi silnik o wersję. Wpisanie w diagramie jednego słowa info sprawia, że Mermaid rysuje własny numer wersji, co jest szybsze niż czytanie listy zmian.

info