Notion · Pratique et outillage
Mermaid
Un langage qui décrit un schéma en quelques lignes de texte : un processus, un organigramme, un calendrier. Comme c’est du texte, une IA sait l’écrire et le relire, et le schéma s’affiche dans la plupart des outils de documentation.
Comment ça marche
Vous décrivez le schéma avec des mots : telle étape mène à telle autre, telle question ouvre deux chemins. Un outil compatible lit ce texte et dessine les boîtes et les flèches à votre place. Vous ne placez rien à la main, la mise en page est calculée.
C’est précisément ce qui intéresse une IA. Un assistant ne sait pas dessiner dans PowerPoint, mais il sait écrire du texte. Demandez-lui « décris ce processus en Mermaid », vous obtenez un schéma. Demandez-lui de déplacer une étape, il réécrit trois lignes.
Un exemple concret
Voici le traitement d’une demande client, tel qu’une équipe pourrait le décrire avant de confier le tri à un assistant. La demande faite à l’IA, le texte qu’elle produit, et le schéma qui en sort.
Ce qu’on demande à l’IA« Décris en Mermaid le tri d’une demande client : l’IA la classe en devis, question ou réclamation. Les devis et les réponses sont relus par un humain avant envoi. Une réclamation déclenche une alerte au responsable. »
flowchart TB
A["Une demande client arrive"] --> B["L'IA la classe"]
B --> C{"Quel type ?"}
C -->|Devis| D["Brouillon de devis"]
C -->|Question| E["Réponse proposée"]
C -->|Réclamation| F["Alerte au responsable"]
D --> G["Un humain relit et envoie"]
E --> G
Les deux étapes en orange sont celles où une personne intervient. Ce genre de schéma sert justement à décider, noir sur blanc, où l’IA agit seule et où quelqu’un relit.
Ce que ça change pour une équipe
- Un processus devient un document. Il se relit, se corrige et se compare d’une version à l’autre, comme un texte. On voit ce qui a changé entre la version de janvier et celle de mars.
- La réunion de cadrage va plus vite. Plutôt que de décrire un enchaînement à l’oral, on projette le schéma, on le modifie en direct, et chacun repart avec la même image.
- L’IA parle le même langage. Un assistant peut lire le schéma d’un processus existant, proposer une version simplifiée, ou produire le schéma d’une automatisation avant qu’on la construise. Et si vous construisez des outils, le schéma devient le cahier des charges.
Les limites et les erreurs fréquentes
- La syntaxe est stricte. Une parenthèse ou un guillemet dans une étiquette suffit à casser l’affichage. Le réflexe : mettre le texte des boîtes entre guillemets, ou demander à l’assistant de corriger l’erreur.
- On ne contrôle pas le dessin. L’outil choisit la disposition. Pour un visuel soigné, destiné à un client, un outil de dessin reste meilleur.
- Un gros schéma devient illisible. Au-delà d’une quinzaine d’étapes, découpez en plusieurs schémas, un par sous-processus.
- Les outils n’affichent pas tous la même chose. Certains types de diagrammes ou certaines options récentes ne passent pas partout. Testez dans l’outil où le schéma vivra.
Pour aller plus loin
Mermaid définit plusieurs types de diagrammes (flowchart, sequence, gantt, class, mindmap…) par une syntaxe textuelle, rendue en SVG par une bibliothèque JavaScript. Le rendu est intégré à GitHub, GitLab, Notion, Obsidian et VS Code. La syntaxe est stricte : une étiquette qui contient des parenthèses ou des caractères spéciaux doit être placée entre guillemets.
Où ça se situe chez Opora
Programme 01 · Mieux utiliserUn usage responsable et sobre de l’IA
Décrire un processus noir sur blanc avant de le confier à l’IA, c’est un réflexe que nous travaillons dès le premier programme. Mermaid en est l’outil le plus simple.
Questions fréquentes
Faut-il savoir coder pour utiliser Mermaid ?
Non. On écrit des phrases courtes avec des flèches, et l’outil dessine. Le plus simple est de demander à un assistant IA de produire le schéma à partir d’une description en français, puis de lui faire corriger ce qui ne va pas.
Où est-ce que le schéma s’affiche ?
Dans la plupart des outils de documentation : GitHub, GitLab, Notion, Obsidian, VS Code, et de nombreux wikis. Pour le voir en dehors de ces outils, le site mermaid.live affiche n’importe quel schéma collé dans la page.
Quelle différence avec un schéma fait dans PowerPoint ou Miro ?
Un schéma Mermaid se relit et se modifie comme un texte, par vous ou par une IA. Un schéma dessiné à la main est plus joli, mais chaque changement se fait à la souris. Pour documenter et faire évoluer un processus, Mermaid gagne. Pour une présentation client soignée, l’outil de dessin garde l’avantage.