Mermaid Design

Premiers pas

mermaid.design est un éditeur de diagrammes Mermaid en ligne. Écrivez la syntaxe Mermaid à gauche et regardez le diagramme se rendre en direct à droite. Tout s’exécute entièrement dans votre navigateur — vos diagrammes ne quittent jamais votre appareil.

Votre premier diagramme

  1. Ouvrez mermaid.design — l’éditeur se charge avec un organigramme d’exemple.
  2. Modifiez le code Mermaid dans le panneau de gauche, par exemple :
flowchart TD
    A[Début] --> B{Prêt ?}
    B -- Oui --> C[Livrer]
    B -- Non --> D[Continuer à coder]
  1. L’aperçu se re-rend automatiquement pendant la saisie (avec un léger délai anti-rebond). Si la syntaxe est invalide, le dernier diagramme valide reste visible derrière une bannière d’erreur, et l’éditeur de code marque la ligne en échec.

L’atelier

L’éditeur est un atelier à trois panneaux :

  • Éditeur de code (à gauche) — un éditeur CodeMirror léger avec coloration syntaxique Mermaid, marqueurs d’erreur en ligne, sélection synchronisée avec le canvas et barre d’outils formater/copier/effacer. Vous pouvez le réduire en une fine bande d’icônes ou faire glisser le séparateur pour le redimensionner.
  • Aperçu (au centre) — le canvas interactif du diagramme. Faites glisser l’espace vide pour déplacer, utilisez Ctrl/⌘ + molette ou pincement pour zoomer, puis le bouton d’ajustement à la vue. L’arrière-plan peut être points / blanc / damier.
  • Panneau de thème (à droite) — préréglages en un clic, variables de thème détaillées et génération de thème à partir d’une couleur de départ. Voir ci-dessous.

Sur les écrans étroits, l’atelier devient un panneau unique avec une barre d’onglets Code / Aperçu / Thème en bas.

Édition visuelle et outils de code

  • Modifier sur le canvas — double-cliquez sur un nœud ou un libellé pour modifier son texte, puis appuyez sur Entrée ou cliquez ailleurs pour valider. Cliquez sur une entité pour ouvrir son panneau d’édition ; selon le type de diagramme, vous pouvez modifier formes, couleurs, connexions et autres propriétés, ou la supprimer.
  • Sélection synchronisée — sélectionner une entité sur le canvas surligne et affiche son code Mermaid. Déplacer le curseur CodeMirror sur le code d’une entité la sélectionne sur le canvas.
  • Historique partagé — Ctrl/⌘+Z et Ctrl/⌘+Shift+Z annulent et rétablissent les modifications du code et du canvas dans un même historique.
  • Recherche et remplacement — Ctrl/⌘+F pour rechercher et Ctrl/⌘+H pour ouvrir le remplacement. Utilisez précédent/suivant, la casse, les expressions régulières, les mots entiers ou le remplacement simple/global ; le canvas est mis à jour aussi.

Modes de rendu

Utilisez le contrôle segmenté dans la barre de navigation pour changer la façon dont votre diagramme est rendu :

  • Officiel — la sortie SVG Mermaid standard, exactement telle que le moteur Mermaid la rend.
  • ASCII — votre diagramme converti en art textuel que vous pouvez coller dans des commentaires de code, des documents ou des terminaux. Voir Rendu ASCII.

Le mode fait partie de l’URL, vous pouvez donc mettre en signet ou partager un lien vers un mode spécifique.

Thèmes

Chaque diagramme est rendu avec le thème base plus un ensemble de plus de 70 variables de thème modifiables :

  • Préréglages — les 11 thèmes Mermaid intégrés (Default, Neutral, Forest, Dark, Base, et plus) plus des préréglages de designer, chacun avec un mini-aperçu.
  • Variables du thème — ajustez les couleurs, bordures et polices individuelles par groupe, avec recherche.
  • Générer — dérivez un thème complet à partir d’une seule couleur de départ, clair ou sombre.

Votre travail est enregistré automatiquement

L’éditeur conserve votre code, votre thème et votre mise en page dans le stockage local de votre navigateur. Fermez l’onglet et revenez plus tard — votre diagramme est toujours là. Rien n’est envoyé vers un serveur.

Prochaines étapes