Comment ouvrir un fichier .mmd

Ce que vous voyez

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

Pourquoi

Vous avez copié le diagramme depuis un fichier Markdown ou une conversation et emporté les délimiteurs avec. Les trois accents graves sont du Markdown, pas du Mermaid : l'analyseur n'atteint jamais le diagramme.

Correction

Supprimez la ligne d'ouverture ```mermaid et la ligne de fermeture ```. Le fichier doit commencer par le mot-clé du diagramme.

```mermaid
flowchart TD
    A[Début] --> B[Fin]
```

flowchart TD
    A[Début] --> B[Fin]

Ce que vous voyez

Parse error, le message se termine par : got 'PS'

L'erreur se termine par: got 'PS'

Pourquoi

Une parenthèse ouvrante dans l'étiquette d'un nœud. Dans Mermaid les parenthèses sont de la syntaxe de forme — A(texte) est un nœud arrondi — donc une parenthèse nue entre crochets est lue comme le début d'une forme.

Correction

Mettez l'étiquette entre guillemets droits. Tout ce qui est entre guillemets est traité comme du texte, crochets compris.

flowchart TD
    A[Appeler encaisser(commande)] --> B[Fin]

flowchart TD
    A["Appeler encaisser(commande)"] --> B[Fin]

Ce que vous voyez

Parse error, le message se termine par : got 'NODE_STRING'

L'erreur se termine par: got 'NODE_STRING'

Pourquoi

Une espace dans l'identifiant d'un nœud. L'identifiant est le jeton qui précède la flèche, et l'espace le termine. Le cas proprement français est l'espace insécable, ordinaire ou fine, que la typographie réclame avant `: ; ! ?` et que les traitements de texte insèrent d'eux-mêmes. Vérifié : elle échoue exactement comme une espace ordinaire, avec le même jeton — le message ne laisse donc rien deviner du caractère invisible.

Correction

Un identifiant en un seul mot, sans espace d'aucune sorte, et le texte lisible dans l'étiquette. Les accents, la cédille et l'apostrophe passent sans problème dans un identifiant.

flowchart TD
    serveur auth --> base[Base de données]

flowchart TD
    auth[Serveur d'authentification] --> base[Base de données]

Ce que vous voyez

Parse error, le message se termine par : got 'STR'

L'erreur se termine par: got 'STR'

Pourquoi

Un guillemet droit dans l'étiquette d'un nœud. L'analyseur y voit le début d'une chaîne entre guillemets, puis tombe sur le crochet de l'étiquette là où il attendait le guillemet fermant.

Correction

Encadrez toute l'étiquette de guillemets droits et utilisez des guillemets français à l'intérieur, ou écrivez le guillemet sous forme d'entité HTML #quot;.

flowchart TD
    A[Il a dit "bonjour"] --> B[Fin]

flowchart TD
    A["Il a dit « bonjour »"] --> B[Fin]

Ce que vous voyez

Parse error, le message se termine par : got 'end'

L'erreur se termine par: got 'end'

Pourquoi

Vous avez utilisé end comme identifiant de nœud. En minuscules, end ferme un sous-graphe : l'analyseur voit une fin de bloc là où il attendait un nœud. Cela arrive souvent, parce qu'en suivant des exemples anglais on finit par appeler end le dernier nœud même si le reste est en français.

Correction

Mettez une majuscule, ou donnez un autre identifiant au nœud et mettez le mot dans l'étiquette. `Fin` ne pose aucun problème.

flowchart TD
    A[Début] --> end

flowchart TD
    A[Début] --> Fin[Terminé]

Ce que vous voyez

Ça se dessine, mais un état s'est scindé en deux dans un diagramme d'états

Pourquoi

Une espace dans l'identifiant d'un état — et c'est ici que l'insécable devient réellement dangereuse. Contrairement à l'organigramme, le diagramme d'états ne proteste pas : il crée une boîte par mot. Mesuré — `[*] --> En attente` donne deux états, `En` et `attente`, dont seul le premier est au bout de la flèche. Comme la typographie française insère ces espaces sans qu'on les demande et qu'elles sont invisibles à l'écran, le diagramme est faux sans le moindre signe.

Correction

Déclarez l'état avec `state "Libellé" as id` et ne le désignez plus que par son identifiant.

stateDiagram-v2
    [*] --> En attente
    En attente --> Clos

stateDiagram-v2
    state "En attente" as attente
    [*] --> attente
    attente --> Clos

Ce que vous voyez

Ça se dessine, mais un diagramme ER contient des entités que vous n'avez pas écrites

Pourquoi

Un libellé d'association contenant une espace et dépourvu de guillemets. C'est le piège qui gêne le plus en français, parce que nos verbes relationnels appellent une préposition : « appartient à », « figure dans ». Mermaid ne renvoie aucune erreur : il coupe le libellé à la première espace et transforme chaque mot restant en entité vide.

Correction

Mettez entre guillemets tout libellé d'association contenant une espace. En français, cela revient à presque tous.

erDiagram
    CLIENT ||--o{ COMMANDE : appartient à

erDiagram
    CLIENT ||--o{ COMMANDE : "appartient à"

Ce que vous voyez

No diagram type detected matching given configuration for text: sequencediagram

Pourquoi

Le mot-clé du diagramme est mal orthographié, ou la casse est fausse. Les mots-clés de Mermaid sont sensibles à la casse : sequenceDiagram fonctionne, sequencediagram non. Il en va de même pour stateDiagram-v2 et erDiagram.

Correction

Corrigez la casse. Notez que graph reste accepté comme ancien alias de flowchart : cette vieille syntaxe n'est donc pas votre problème.

sequencediagram
    Client->>API: Bonjour

sequenceDiagram
    Client->>API: Bonjour

Ce que vous voyez

Parse error sur une étiquette d'arête entre barres

Pourquoi

Des parenthèses dans l'étiquette d'une arête. L'étiquette |...| subit la même contrainte qu'une étiquette de nœud : les parenthèses y sont de la syntaxe, pas du texte.

Correction

Mettez l'étiquette d'arête entre guillemets.

flowchart TD
    A -->|oui (toujours)| B

flowchart TD
    A -->|"oui (toujours)"| B

Ce que vous voyez

Parse error signalée à la dernière ligne du diagramme

Pourquoi

Un bloc ouvert et jamais fermé : alt, opt, loop, par et subgraph réclament tous leur end. Mermaid signale l'échec au moment où il arrive au bout de l'entrée, si bien que le numéro de ligne désigne la fin du fichier et non le bloc resté ouvert.

Correction

Comptez les blocs ouverts et les end écrits. Quand l'erreur porte sur la dernière ligne, c'est presque toujours cela.

sequenceDiagram
    Client->>API: Requête
    alt Tout va bien
        API-->>Client: OK

sequenceDiagram
    Client->>API: Requête
    alt Tout va bien
        API-->>Client: OK
    end

Ce que vous voyez

Lexical error on line 1. Unrecognized text.

Pourquoi

Une direction invalide après le mot-clé du diagramme. Les organigrammes acceptent TB, TD, BT, LR et RL, et rien d'autre ; une faute de frappe ici échoue à l'analyse lexicale, avant la lecture du moindre nœud.

Correction

Utilisez l'une des cinq directions valides. TD et LR couvrent presque tous les cas.

flowchart XY
    A --> B

flowchart TD
    A --> B

Ce que vous voyez

Ça se dessine ici mais pas dans GitLab, Confluence ou un outil ancien

Pourquoi

Une différence de version. Cette visionneuse tourne en Mermaid 11.12.2 ; GitLab.com documente la version 10, et les wikis auto-hébergés ont souvent des années de retard. La syntaxe introduite après la version de l'autre outil s'analyse ici et échoue là-bas.

Correction

Demandez à l'autre moteur quelle version il utilise. Écrire le seul mot info dans un diagramme fait afficher à Mermaid son propre numéro de version, ce qui va plus vite que de lire les notes de publication.

info