Si votre priorité est la documentation technique automatisée, choisissez diagram-design ; si vous devez versionner une syntaxe textuelle, choisissez Mermaid Chart ; si vous voulez une toile libre à ajuster à la main, choisissez Excalidraw. Aucun de ces outils n’est le meilleur dans tous les contextes.
Dernière mise à jour : 14 août 2026. Les fonctions et formats ont été vérifiés à partir des dépôts et documentations officielles de diagram-design, Mermaid et Excalidraw à cette date.
Cet article s’adresse aux développeurs qui ajoutent régulièrement des schémas dans des README, aux équipes qui maintiennent leurs diagrammes dans un dépôt Git et aux responsables techniques qui évaluent un flux de travail avec Claude Code. Il concerne aussi les rédacteurs techniques et les équipes produit qui doivent passer rapidement d’une idée à une illustration exploitable dans un article, une vidéo ou une présentation.
Le livrable avant l’outil
La première erreur consiste à comparer les trois solutions comme s’il s’agissait de simples générateurs d’images. Elles produisent pourtant des livrables différents :
- diagram-design génère principalement des fichiers HTML autonomes avec SVG et CSS intégrés ;
- Mermaid Chart travaille à partir d’une syntaxe textuelle Mermaid, rendue sous forme de diagramme ;
- Excalidraw fournit une toile libre dont la scène peut être sauvegardée, modifiée et exportée.
Le choix doit donc commencer par la destination du diagramme.
Pour un README, un site technique ou une documentation qui sera régulièrement modifiée, un fichier texte ou un SVG réutilisable est généralement plus facile à maintenir qu’une capture d’écran. Pour une page éditoriale ou une illustration de blog, un HTML autonome permet de conserver la mise en page et les styles. Pour une réunion de conception, un tableau blanc offre davantage de liberté qu’un langage déclaratif.
Cette distinction évite trois coûts cachés :
- Le coût de migration : un diagramme produit dans un format difficile à importer devra être redessiné lorsque le support de publication changera.
- Le coût de correction : plus la structure est complexe, plus il devient important de pouvoir modifier directement les relations, les libellés et les groupes.
- Le coût de maintenance : un fichier binaire ou une image aplatie ne montre pas clairement ce qui a changé dans une revue de code.
Le dépôt officiel de Mermaid présente son approche comme une génération à partir de texte proche de Markdown, avec un objectif de documentation modifiable et compatible avec le contrôle de version.
Les trois routes de génération
diagram-design : le meilleur choix pour produire une figure éditoriale
diagram-design est une compétence destinée aux agents de développement comme Claude Code. Son dépôt officiel indique qu’elle génère des diagrammes sous forme de HTML autonome et de SVG, sans étape de compilation, dépendance d’image externe ou bibliothèque d’interface à installer pour ouvrir le résultat dans un navigateur.
Le projet documente actuellement 27 types visuels, parmi lesquels les architectures, les organigrammes, les séquences, les machines à états, les modèles de données, les frises chronologiques, les diagrammes de Venn, les quadrants et les flux de données. Ce nombre est une information de couverture fonctionnelle, pas une preuve que chaque type sera adapté à votre contenu.
Son avantage réel apparaît lorsque vous partez d’un texte descriptif et que vous voulez obtenir une figure directement exploitable dans un article :
- le document complet peut rester dans un fichier HTML ;
- le SVG peut être extrait pour une intégration dans un site ou un outil graphique ;
- le style peut être aligné sur une charte existante ;
- la sortie peut être adaptée à une page, une diapositive ou un visuel social ;
- la compétence peut aussi importer une source Mermaid ou draw.io pour la redessiner.
Le dépôt décrit également des niveaux de détail et des formats de sortie distincts, notamment HTML, SVG, PNG et HTML accompagné d’une image. Il précise que l’export PNG passe par Playwright et Chromium, ce qui est important si vous prévoyez une automatisation dans un environnement distant.
Point faible : diagram-design n’est pas un tableau blanc collaboratif généraliste. Les modifications se font surtout dans le fichier source, dans les instructions de l’agent ou dans le HTML/SVG produit. Pour une équipe qui veut déplacer librement des objets pendant une réunion, l’expérience sera moins naturelle qu’avec Excalidraw.
Mermaid Chart : la meilleure option pour la syntaxe, Git et les intégrations
Mermaid Chart convient mieux lorsque le diagramme doit rester lié à un fichier texte. La syntaxe Mermaid peut être stockée dans un dépôt, relue dans une pull request et régénérée après modification de l’architecture. Le dépôt officiel Mermaid met en avant plus de 20 types de diagrammes, une syntaxe inspirée de Markdown, le rendu natif dans GitHub et la compatibilité avec les revues de code.
Mermaid Chart ajoute une interface web, une génération à partir d’une consigne et une édition visuelle. Sa documentation officielle décrit un éditeur avec assistant IA, aperçu rendu, historique local, éditeur de texte, partage et export.
L’intérêt de Mermaid Chart n’est donc pas seulement de « demander un diagramme à une IA ». Vous conservez une source que vous pouvez relire et corriger :
flowchart LR
Client --> API
API --> Service
Service --> BaseDeDonnees
Cette approche est particulièrement adaptée aux architectures, aux flux de données, aux séquences d’authentification et aux diagrammes d’état. Elle devient moins confortable lorsque vous cherchez une composition très libre, une hiérarchie visuelle atypique ou une illustration destinée à un public non technique.
Mermaid Chart documente l’export en PNG, SVG, MMD et PDF. Le fichier MMD conserve la syntaxe brute, ce qui le rend intéressant pour le versionnage et la réutilisation dans un autre outil compatible. Les formats disponibles sont détaillés dans la documentation officielle des exports Mermaid Chart.
Point faible : la disposition est fortement liée au moteur de rendu et à la syntaxe choisie. Vous pouvez ajuster les relations, la direction, les thèmes et les libellés, mais vous ne disposez pas de la même liberté qu’avec une toile où chaque élément peut être déplacé indépendamment.
Excalidraw : le meilleur choix pour le tableau blanc et l’ajustement manuel
Excalidraw adopte une logique différente. L’éditeur est conçu autour d’une toile libre, d’un style manuscrit et d’une collaboration visuelle. Le dépôt officiel d’Excalidraw mentionne la collaboration en temps réel, les liens partageables, la prise en charge hors ligne, l’enregistrement local dans le navigateur et l’export d’un fichier JSON au format ouvert.
La solution est très pertinente pour :
- une réunion de conception produit ;
- un atelier de cadrage avec des personnes non techniques ;
- un storyboard audio ou vidéo ;
- une carte d’expérience utilisateur ;
- une première architecture encore instable ;
- une illustration que vous devez corriger rapidement à la souris.
Excalidraw peut-il générer automatiquement un organigramme ou un flux avec une IA ? Oui, mais il faut distinguer l’éditeur libre de ses fonctions IA et intégrations spécifiques. La documentation Excalidraw+ sur MCP décrit une intégration destinée à permettre à un agent de créer ou modifier des éléments sur la toile.
Cela ne signifie pas que chaque installation locale d’Excalidraw offre automatiquement le même parcours IA. Vérifiez la fonction, le compte requis et le mode d’intégration avant de concevoir votre processus autour d’elle.
Son export est flexible : la documentation technique des exports Excalidraw décrit les sorties PNG, SVG et JSON, ainsi que l’accès programmatique à la scène.
Point faible : le fichier JSON conserve bien la scène, mais il n’offre pas toujours la lisibilité d’un fichier Mermaid lors d’une revue Git. Une modification de position ou de style peut produire un diff difficile à interpréter pour une équipe de développeurs.
Comparatif par indicateur
| Critère de décision | diagram-design | Mermaid Chart | Excalidraw |
|---|---|---|---|
| Source principale | HTML et SVG autonomes | Syntaxe Mermaid textuelle | Scène graphique et JSON |
| Génération avec IA | Très adaptée via Claude Code | Assistant IA intégré et syntaxe Mermaid | Fonctions IA et intégrations à vérifier |
| Modification fine | HTML, SVG et consignes de l’agent | Code ou éditeur visuel | Déplacement libre sur la toile |
| Contrôle de version | Bon pour le fichier source, moins lisible pour chaque détail visuel | Excellent pour la logique déclarative | Correct pour l’archive, moins lisible en diff |
| Sorties documentées | HTML, SVG, PNG | PNG, SVG, MMD, PDF | PNG, SVG, JSON |
| Collaboration | À organiser autour des fichiers et du dépôt | Partage, commentaires et édition selon l’offre | Collaboration en temps réel sur la toile |
| Meilleur contexte | Articles, docs, visuels de marque | README, wikis, dépôts, CI | Ateliers, brainstormings, présentations |
| Contraintes à surveiller | Environnement d’agent et navigateur pour certains exports | Rendu et syntaxe à maintenir | Fonction IA et gestion du fichier de scène |
Ce tableau ne constitue pas une note globale. La bonne décision dépend de l’indicateur qui coûte le plus cher dans votre workflow : la maintenance, la liberté graphique, la collaboration ou la livraison.
Qualité des sorties et contrôle des diagrammes complexes
Un diagramme simple peut être généré avec les trois approches. La différence apparaît lorsque vous ajoutez des exceptions, des branches, des systèmes externes et plusieurs niveaux de responsabilité.
Architecture avec relations nombreuses
Pour une architecture logicielle destinée à un README, Mermaid Chart est souvent le choix le plus prévisible : les composants et les relations sont écrits explicitement. Vous pouvez demander à l’agent de ne modifier que les nœuds concernés, puis relire le changement dans le fichier source.
diagram-design est plus intéressant si la figure doit aussi expliquer le système à un lectorat extérieur à l’équipe. Ses types visuels et ses niveaux de détail permettent de transformer une description technique en illustration plus éditoriale. Le projet documente notamment une adaptation de la densité et du vocabulaire selon le format et le public visé.
Excalidraw convient lorsque la structure n’est pas encore arrêtée. Vous pouvez dessiner une frontière, ajouter une note, déplacer un service et annoter une hypothèse sans attendre que la syntaxe accepte exactement votre représentation.
Flux métier avec exception
Pour un flux comportant des décisions, Mermaid est efficace si les règles peuvent être exprimées clairement dans le langage. diagram-design devient plus attractif lorsque vous voulez mettre en évidence un chemin principal, une boucle ou une zone de risque avec un style visuel cohérent.
Excalidraw reste le plus simple pour une discussion exploratoire, mais il demande une étape de normalisation si le croquis doit ensuite devenir une documentation durable.
Attention : une image exportée ne prouve pas que la logique est correcte. Faites relire la source, les branches et les exceptions séparément du rendu visuel, surtout pour une architecture de production ou un schéma de sécurité.
Édition, Git et maintenance à long terme
diagram-design et Mermaid Chart sont-ils équivalents pour une documentation technique ? Non. Ils peuvent produire des SVG et des visuels propres, mais ils ne conservent pas la même représentation du contenu.
Mermaid encode d’abord les relations dans une syntaxe lisible. C’est un avantage pour :
- comparer deux versions dans Git ;
- faire relire une modification par un développeur ;
- générer plusieurs rendus depuis la même source ;
- intégrer le diagramme dans Markdown ;
- automatiser un contrôle dans une chaîne de documentation.
diagram-design encode davantage la composition finale. C’est préférable lorsque la hiérarchie graphique, les annotations, la typographie et la mise en page font partie du message. Vous pouvez garder le HTML autonome dans le dépôt, mais la revue d’un changement visuel demandera souvent un aperçu rendu en complément du diff.
Excalidraw est le meilleur outil des trois pour préserver une intention de tableau blanc. Son format JSON ouvert permet de sauvegarder la scène et de la réimporter, mais une équipe qui veut comprendre chaque modification devra examiner le fichier dans l’éditeur plutôt que de compter uniquement sur Git.
Collaboration, intégration et livraison
Mermaid Chart documente plusieurs modes de partage : lien en lecture seule, lien autorisant la modification, lien SVG vivant et invitation de collaborateurs. La documentation officielle du partage Mermaid Chart précise que la coédition en temps réel dépend du niveau de service concerné ; il ne faut donc pas confondre le moteur Mermaid open source avec toutes les fonctions de la plateforme hébergée.
Excalidraw est naturellement adapté à la collaboration visuelle. Sa documentation officielle de collaboration décrit une synchronisation par WebSocket, la présence des collaborateurs, le partage de fichiers et le chiffrement de bout en bout dans son système de collaboration.
Pour un article, un tutoriel vidéo ou une présentation produit, le choix du format compte davantage que le nom du logiciel :
- choisissez SVG pour une intégration web nette et redimensionnable ;
- choisissez PNG pour une diapositive, une miniature ou un montage vidéo ;
- conservez le HTML lorsque la mise en page complète fait partie du livrable ;
- gardez le MMD ou le JSON lorsque vous devez rééditer la source.
Une équipe qui produit des captures pour des vidéos ou des démonstrations audio-visuelles doit aussi vérifier les polices, les dimensions de la page et le fond transparent avant d’automatiser les exports.
Installation, automatisation et environnement
Le choix de l’outil implique aussi un choix d’environnement.
diagram-design avec Claude Code demande un agent compatible, un projet local et, pour l’export PNG documenté par le dépôt, une installation de Playwright et de Chromium. Cela peut rester local sur votre Mac, mais devient plus pratique sur une machine distante lorsque vous devez lancer régulièrement des rendus, conserver un environnement stable ou partager le même poste de travail entre plusieurs rédacteurs.
Mermaid Chart réduit la maintenance locale pour la génération et le partage dans le navigateur. En revanche, une équipe qui veut intégrer Mermaid dans une chaîne de publication devra toujours vérifier le moteur de rendu, les extensions autorisées et la façon dont les thèmes sont appliqués.
Excalidraw est rapide à utiliser dans le navigateur et peut être intégré comme composant dans une application. Pour une automatisation avancée, vous devrez gérer la scène, les fichiers associés, les droits de collaboration et le rendu final.
Claude Code doit-il utiliser quel outil pour produire une architecture ? Utilisez diagram-design si le résultat attendu est une figure éditoriale autonome en HTML ou SVG. Utilisez Mermaid Chart si l’architecture doit rester dans un README ou être discutée dans une pull request. Utilisez Excalidraw si Claude doit alimenter une toile collaborative que vous corrigerez ensuite manuellement.
Avant de lancer une production automatisée, vérifiez :
- [ ] Le format final est défini : HTML, SVG, PNG, MMD ou JSON.
- [ ] La source modifiable est conservée avec le fichier livré.
- [ ] Le diagramme possède un nom et un emplacement stables dans le dépôt.
- [ ] Les polices et ressources externes sont autorisées dans votre contexte de publication.
- [ ] Le rendu est vérifié dans le navigateur ou l’outil de destination.
- [ ] Les exports PNG et SVG sont contrôlés sur un cas comportant des libellés longs.
- [ ] Les branches, relations et exceptions sont relues séparément de la mise en page.
- [ ] L’équipe sait qui peut modifier la source et qui valide la version publiée.
Pour des opérations répétées, un environnement Mac distant peut éviter les écarts entre postes locaux, notamment lorsque le workflow combine Claude Code, un navigateur, des scripts d’export et une chaîne de publication. Vous pouvez consulter la présentation de l’infrastructure Mac de Kvmjet avant de choisir entre un poste local et une session distante.
Classement par scénario
Documentation dans un dépôt de code
Premier choix : Mermaid Chart. La source textuelle, le rendu Markdown et la logique déclarative correspondent au fonctionnement d’un dépôt.
Alternative : diagram-design. Choisissez-le lorsque la documentation doit ressembler à une figure éditoriale plutôt qu’à un schéma strictement technique.
Excalidraw devient le troisième choix pour ce scénario, sauf si le diagramme est encore au stade de conception.
Illustration de blog technique
Premier choix : diagram-design. Le HTML autonome, le SVG, les variantes visuelles et l’adaptation à une charte rendent la sortie plus facile à intégrer dans un article.
Alternative : Mermaid Chart. Il convient si vous souhaitez que les lecteurs puissent retrouver la logique sous forme de code ou si le blog est déjà construit autour de Markdown.
Excalidraw est pertinent pour une image volontairement manuscrite, un tutoriel débutant ou une explication de produit plus créative.
Tableau blanc collaboratif
Premier choix : Excalidraw. La toile libre réduit le coût de modification pendant une réunion et permet de mélanger formes, notes, flèches et annotations.
Alternative : Mermaid Chart. Utilisez-le lorsque la réunion doit aboutir à une source technique propre et versionnée.
diagram-design est mieux placé après l’atelier, pour transformer la décision validée en illustration publiée.
Présentation non technique
Premier choix : Excalidraw pour une explication progressive, un storyboard audio ou vidéo, ou une présentation où l’aspect esquissé facilite la discussion.
Alternative : diagram-design pour une figure structurée avec une identité visuelle maîtrisée.
Mermaid Chart reste intéressant si le public doit inspecter une architecture ou un processus détaillé, mais il peut sembler trop technique dans une présentation destinée à des décideurs.
Verdict d’achat et prochaines étapes
Ne choisissez pas uniquement l’outil qui produit le plus de types de diagrammes. Votre décision doit suivre la forme du livrable : diagram-design pour l’illustration technique automatisée, Mermaid Chart pour la source textuelle versionnée, Excalidraw pour l’exploration et la collaboration visuelle.
Si votre méthode actuelle repose sur des captures d’écran manuelles, des fichiers impossibles à comparer ou un poste local qui ne dispose pas toujours des mêmes dépendances de navigateur, vous payez déjà un coût de maintenance : rendu non reproductible, corrections dispersées et exports difficiles à relancer. Dans ce cas, louer un environnement Mac avec Kvmjet peut être plus confortable pour tester Claude Code, exécuter un navigateur stable et préparer des exports SVG ou PNG sans immobiliser votre machine principale.
Cette option n’est toutefois pas universelle. Pour un besoin permanent et lourd, l’achat d’un Mac peut être plus rationnel ; pour une simple modification ponctuelle, votre poste local suffit probablement. Si vous devez seulement valider un workflow de génération, consultez aussi le centre d’aide de Kvmjet, puis examinez un nœud Mac M4 en Silicon Valley lorsque vous avez besoin d’un environnement distant pour Claude Code, le rendu dans un navigateur ou une série d’exports.
Concevez vos diagrammes dans un environnement Mac performant
Accédez à un Mac mini M4 bare-metal avec Kvmjet pour créer, modifier et présenter vos diagrammes à distance avec une expérience macOS complète.
Profitez d’une machine dédiée, d’une adresse IPv4 exclusive et d’une bande passante de 1 Gbit/s pour travailler avec fluidité sur vos projets techniques.