Situation. Votre architecture, votre flux de données ou votre processus mérite un schéma. Vous voulez qu’il vive dans le dépôt, se relise dans un diff, et ne dépende d’aucun outil en ligne.
Ce que vous obtenez à la fin. Un diagramme Mermaid en texte, rendu localement, intégré à votre documentation ou exporté en image.
1. Partir d’un modèle plutôt que d’une page blanche
Fichier > Nouveau fichier (⌘N), puis choisissez un diagramme Mermaid.
La galerie propose les 28 familles reconnues, 16 modèles recommandés, et une recherche par usage et par type. Trois champs de personnalisation vous laissent ajuster le départ avant de créer le fichier.
Si vous ne savez pas quelle famille choisir, cherchez par ce que vous voulez montrer plutôt que par le nom technique.
2. Construire
Deux façons de travailler, sur le même fichier.
Sur le rendu : un clic sélectionne, un double-clic sur un nœud modifie son libellé, un double-clic sur le fond ajoute un nœud, la touche Supprimer retire la sélection. Une poignée distincte sert à créer les relations.
Par la structure : la navigation de gauche expose les déclarations du diagramme. Sélectionnez pour modifier les champs, Ajouter pour insérer, Monter et Descendre pour réordonner.
En mode Source, vous écrivez le langage Mermaid directement.
3. Accepter que la mise en page ne vous appartienne pas
Mermaid calcule la disposition. Un élément que vous déplacez sans que le déplacement ait un sens dans la grammaire revient à sa place calculée.
Ce n’est pas un défaut : c’est ce qui garantit que le fichier texte contient tout le diagramme. Pour influencer la disposition, changez la direction ou l’ordre des déclarations.
4. Mettre le diagramme dans la documentation
Dans un document Markdown, Insérer ouvre la même galerie et pose le diagramme dans une clôture calculée pour ne pas entrer en conflit avec le contenu.
Pour modifier un bloc existant, Modifier ouvre la même surface dans une fenêtre à part. Le brouillon reste isolé : Annuler ne touche pas au document, Appliquer ne remplace que l’intérieur du bloc.
5. Exporter quand une image est nécessaire
Copiez la source, copiez l’image, ou exportez en SVG et en PNG.
L’image exportée est celle qui a été assainie pour l’affichage : ni script, ni lien actif.
Gardez le .mmd dans le dépôt même quand vous livrez un PNG. L’image se régénère ; le texte, lui, se relit et se modifie.
6. Constituer votre bibliothèque
Désignez un dossier local comme bibliothèque de modèles personnels. Ce sont de simples fichiers .mmd ou .mermaid.
Depuis un diagramme ouvert, Enregistrer une copie comme modèle… l’y ajoute.
Oublier ce dossier retire seulement son accès de Balise, sans supprimer un seul fichier.
Si ça ne se passe pas comme prévu
- Rendu vide, erreur, modification impossible : Quand un diagramme ne s’affiche pas
- Détail de chaque commande : L’espace Mermaid