Guide de l'utilisateur de Mermster

Démarrage rapide : votre premier diagramme

Vous pouvez passer du lancement à un diagramme terminé en environ 60 secondes.

1. Lancez Mermster. L’écran d’accueil affiche des options pour créer un nouveau diagramme ou choisir parmi 12 modèles intégrés.
2. Choisissez un modèle (ou partez d’un diagramme vierge). Les modèles couvrent les organigrammes, les diagrammes de séquence, les diagrammes de classes et bien plus encore. Cliquez sur n’importe quel modèle pour l’ouvrir dans un nouvel onglet, prêt à être modifié.
3. Modifiez à gauche, prévisualisez à droite. Saisissez la syntaxe Mermaid dans l’éditeur de code à gauche. Le diagramme s’affiche en temps réel à droite.
4. Exportez votre diagramme. Appuyez sur Cmd+Shift+E (macOS) ou Ctrl+Shift+E (Windows) pour ouvrir la boîte de dialogue d’exportation, puis choisissez SVG, PNG ou PDF, ajustez les paramètres et enregistrez.

C’est tout. Vous avez créé et exporté un diagramme.

Gratuit ou payant

Mermster fonctionne dès le départ, avec un accès complet à toutes les fonctionnalités. La seule différence entre la version gratuite et la version sous licence tient à l’apparence des exports.

Ce qui est inclus gratuitement

• Éditeur de code Monaco complet avec les 10 thèmes
• Les plus de 12 types de diagrammes Mermaid
• Aperçu en direct avec déplacement, zoom et minicarte
• Export en SVG, PNG et PDF (avec un petit filigrane « Made with Mermster »)
• Copie dans le presse-papiers (PNG et SVG)
• Prise en charge de l’impression
• Palette de commandes, constructeur de diagrammes, navigateur de plan
• Historique des versions avec vue des différences
• Sauvegarde automatique et récupération après plantage
• 12 modèles intégrés et modèles personnalisés
• Préréglages d’exportation (5 intégrés + personnalisés)
• 4 palettes de diagramme adaptées au daltonisme
• 7 langues d’interface

Ce qu’ajoute une licence

Des exports propres, sans filigrane. C’est la seule différence.

Les deux licences sont des achats uniques. Sans abonnement. Les mises à jour sont incluses.

L’éditeur

Le volet de gauche est un éditeur de code complet, basé sur la même technologie que Visual Studio Code (l’éditeur Monaco). Il est conçu pour rendre l’écriture de la syntaxe Mermaid aussi fluide que possible.

Coloration syntaxique

Les mots-clés Mermaid, les ID de nœud, les flèches, les étiquettes et les commentaires sont colorés pour que vous puissiez lire votre diagramme d’un coup d’œil. La coloration s’adapte au thème de l’éditeur que vous choisissez.

Saisie semi-automatique

Pendant que vous tapez, Mermster suggère :

• Mots-clés Mermaid : types de diagrammes (graph, sequenceDiagram, classDiagram, etc.), directions (TD, LR, BT, RL) et mots-clés de bloc (loop, alt, opt, end).
• ID de nœud : une fois que vous définissez un nœud, son ID devient disponible pour la saisie semi-automatique partout ailleurs. Cela évite les fautes de frappe et fait gagner du temps sur les grands diagrammes.

Appuyez sur Tab ou Entrée pour accepter une suggestion.

Diagnostic des erreurs

Si votre syntaxe comporte une erreur, Mermster souligne la zone problématique d’un trait ondulé rouge et affiche une description dans la marge de l’éditeur. Cela se met à jour en temps réel pendant que vous tapez.

Rechercher et remplacer

Utilisez Cmd+F (macOS) ou Ctrl+F (Windows) pour ouvrir Rechercher. Utilisez Cmd+H / Ctrl+H pour rechercher et remplacer.

Paramètres de l’éditeur

Personnalisez l’éditeur dans Paramètres (Cmd+, / Ctrl+,), dans la section Éditeur :

Aperçu en direct

Le volet de droite affiche votre diagramme rendu en temps réel. Les modifications apparaissent environ 300 millisecondes après que vous arrêtez de taper, ce qui rend l’aperçu réactif sans scintiller à chaque frappe.

Déplacement et zoom

• Faites défiler pour zoomer et dézoomer.
• Pincez sur un trackpad pour zoomer.
• Cliquez et faites glisser pour vous déplacer dans le diagramme.
• Utilisez les commandes de zoom dans le coin inférieur droit pour des ajustements précis.

Ajuster à la vue

Cliquez sur le bouton Ajuster dans les commandes de zoom pour mettre le diagramme à l’échelle afin qu’il s’inscrive entièrement dans l’aperçu. Cliquez sur 1:1 pour revenir à la taille réelle.

Aperçu en plein écran

Appuyez sur Cmd+Shift+F (macOS) ou Ctrl+Shift+F (Windows) pour masquer l’éditeur et n’afficher que le diagramme dans la fenêtre. Appuyez sur Échap pour revenir à la vue partagée. C’est utile pour les présentations.

Minicarte du diagramme

Pour les grands diagrammes, un aperçu miniature apparaît dans le coin de l’aperçu. Il affiche votre zone visible actuelle sous forme de rectangle. Cliquez n’importe où sur la minicarte pour accéder à cette zone. Activez-la dans Paramètres > Aperçu > Minicarte du diagramme.

Palettes de diagramme

Mermster propose quatre palettes de couleurs pour les diagrammes, dont trois options adaptées au daltonisme :

Changez de palette dans Paramètres > Apparence > Palette du diagramme. La palette s’applique à la fois à l’aperçu en direct et aux diagrammes exportés.

Travailler avec les fichiers

Créer un nouveau diagramme

Appuyez sur Cmd+N (macOS) ou Ctrl+N (Windows). Vous pouvez partir d’un diagramme vierge, choisir parmi 12 modèles intégrés ou utiliser l’un de vos propres modèles enregistrés.

Les modèles intégrés couvrent :

• Base : Organigramme, Diagramme de séquence, Diagramme de classes, Diagramme ER, Diagramme d’états
• Projet : Diagramme de Gantt, Chronologie
• Créatif : Carte mentale
• Données : Diagramme circulaire, Diagramme en quadrants
• Développement : Graphique Git
• UX : Parcours utilisateur

Ouvrir des fichiers

Appuyez sur Cmd+O / Ctrl+O pour ouvrir un fichier .mmd ou .mermaid existant. Vous pouvez aussi faire glisser un fichier sur la fenêtre Mermster, ou double-cliquer sur un fichier .mmd dans le Finder ou l’Explorateur.

Enregistrer

• Cmd+S / Ctrl+S : Enregistrer. Si le fichier n’a jamais été enregistré, vous serez invité à choisir un emplacement.
• Cmd+Shift+S / Ctrl+Shift+S : Enregistrer sous.

Mermster utilise l’extension .mmd par défaut. Les fichiers portant l’extension .mermaid sont également pris en charge.

Édition multi-onglets

Chaque fichier s’ouvre dans son propre onglet. Vos modifications et l’historique d’annulation sont conservés séparément pour chaque onglet.

• Cmd+W / Ctrl+W : Ferme l’onglet actuel (propose d’enregistrer s’il y a des modifications non enregistrées).
• Cmd+Shift+T / Ctrl+Shift+T : Rouvre le dernier onglet fermé.

Surveillance des fichiers

Si un fichier que vous avez ouvert est modifié en externe (par un autre éditeur, une opération Git, etc.), Mermster détecte le changement. Si vous n’avez aucune modification non enregistrée, il se recharge automatiquement. Si vous en avez, une boîte de dialogue vous demande s’il faut recharger depuis le disque ou conserver votre version.

Fichiers récents

L’écran d’accueil affiche vos fichiers récemment ouverts. Ils figurent également dans le menu Fichier.

Exporter des diagrammes

Mermster exporte vers trois formats : SVG, PNG et PDF.

Boîte de dialogue d’exportation

Appuyez sur Cmd+Shift+E (macOS) ou Ctrl+Shift+E (Windows) pour l’ouvrir. Chaque format a son propre onglet avec des options spécifiques :

Exportation rapide

Appuyez sur Cmd+E / Ctrl+E pour exporter immédiatement selon votre dernier préréglage. Si vous n’avez jamais exporté auparavant, la boîte de dialogue complète s’ouvre à la place.

Préréglages d’exportation

Enregistrez vos options d’exportation sous forme de préréglage nommé pour obtenir un résultat cohérent à chaque fois. Mermster inclut 5 préréglages intégrés :

• PNG rapide (Retina)
• SVG rapide
• PNG Retina pour documents
• PDF A4
• PDF Letter

Vous pouvez créer autant de préréglages personnalisés que nécessaire. Si vous modifiez les options après avoir sélectionné un préréglage, le menu déroulant affiche (Modifié) pour vous indiquer que les paramètres ont été modifiés.

Copier dans le presse-papiers

• Cmd+Shift+C / Ctrl+Shift+C : Copier en PNG (pour coller dans des présentations, des documents ou des messages).
• Copier en SVG est disponible via la palette de commandes ou le menu Édition.

Une notification confirme la réussite de la copie.

Impression

Appuyez sur Cmd+P / Ctrl+P pour ouvrir la boîte de dialogue d’impression de votre système.

Outils et navigation

Palette de commandes

Appuyez sur Cmd+K (macOS) ou Ctrl+K (Windows) pour ouvrir la palette de commandes. Commencez à taper pour rechercher n’importe quelle commande : changer de thème, exporter, ouvrir les paramètres, afficher ou masquer des panneaux, et plus encore. Les raccourcis clavier s’affichent à côté de chaque commande, ce qui en fait un excellent moyen de les apprendre au fil de l’eau.

Navigateur de plan

Appuyez sur Cmd+Shift+O ou Ctrl+Shift+O pour ouvrir le panneau de plan. Il affiche un aperçu structuré de votre diagramme : nœuds, arêtes, participants, états et autres éléments, tous regroupés par type. Cliquez sur n’importe quel élément pour accéder à sa ligne dans l’éditeur.

Constructeur de diagrammes

Appuyez sur Cmd+Shift+B ou Ctrl+Shift+B pour ouvrir le panneau du constructeur de diagrammes. Il affiche des boutons contextuels en fonction du type de diagramme que vous modifiez. Cliquez sur n’importe quel bouton pour insérer la syntaxe Mermaid correspondante à la position du curseur, avec un texte d’espace réservé que vous pouvez parcourir à l’aide de la touche Tab.

Le constructeur de diagrammes s’adapte à votre type de diagramme :

Modèles

Mermster prend en charge deux types de modèles :

• Modèles intégrés : 12 diagrammes de départ disponibles sur l’écran d’accueil et lors de la création d’un nouveau fichier.
• Modèles personnalisés : Enregistrez n’importe quel diagramme en tant que modèle réutilisable via Fichier > Enregistrer comme modèle ou depuis la palette de commandes. Donnez-lui un nom, une description facultative et une catégorie. Vos modèles apparaissent dans Mes modèles à chaque création d’un nouveau fichier.

Sécurité des données

Mermster protège automatiquement votre travail, afin que vous n’ayez pas à craindre de le perdre.

Sauvegarde automatique

Mermster enregistre, à intervalles réguliers, une copie de récupération de votre travail non enregistré. Si l’application se ferme de façon inattendue, votre travail vous attend lorsque vous la relancez. Vous pouvez ajuster l’intervalle dans Paramètres > Sécurité des données > Intervalle de sauvegarde automatique (options : désactivé, 15 secondes, 30 secondes, 1 minute ou 2 minutes).

Récupération après plantage

Si Mermster ne se ferme pas correctement (un plantage, une fermeture forcée ou une coupure de courant), une boîte de dialogue de récupération s’affiche au prochain lancement. Elle répertorie tous les documents comportant des modifications non enregistrées et vous permet de :

• Récupérer : restaure le document dans un nouvel onglet.
• Abandonner : supprime définitivement les données de récupération.
• Tout récupérer / Tout abandonner : tout gérer en une seule fois.

Vous pouvez aussi rechercher Récupérer le travail non enregistré dans la palette de commandes à tout moment.

Historique des versions

Chaque fois que vous enregistrez, Mermster prend un instantané. Parcourez les versions précédentes, comparez-les côte à côte avec votre fichier actuel et restaurez n’importe quelle version.

Ouvrez l’historique des versions avec Cmd+Shift+H (macOS) ou Ctrl+Shift+H (Windows), ou allez dans Fichier > Historique des versions.

Dans le panneau de l’historique des versions, vous pouvez :

• Comparer : voir une comparaison côte à côte entre votre fichier actuel et une version sélectionnée.
• Restaurer : ouvrir une version précédente dans un nouvel onglet.
• Supprimer : retirer des versions individuelles ou effacer l’historique complet d’un fichier.

Configurez le nombre maximal de versions par fichier dans Paramètres > Sécurité des données > Nombre maximal de versions par fichier (options : 10, 25, 50 ou 100). Les enregistrements identiques sont automatiquement ignorés.

Personnalisation

Ouvrez les paramètres avec Cmd+, (macOS) ou Ctrl+, (Windows).

Thèmes de l’application

Mermster propose cinq modes de thème :

Thèmes de l’éditeur

Indépendamment du thème de l’application, vous pouvez choisir un jeu de couleurs pour l’éditeur de code. Mermster inclut 10 thèmes d’éditeur :

Réglez-le sur Automatique (la valeur par défaut) pour que le thème de l’éditeur suive automatiquement celui de votre application. Changez les thèmes de l’éditeur dans Paramètres > Apparence > Thème de l’éditeur.

Langue

Mermster est disponible en 7 langues : anglais, japonais (日本語), chinois simplifié (简体中文), chinois traditionnel (繁體中文), espagnol (Español), français (Français) et allemand (Deutsch). Changez de langue dans Paramètres > Général > Langue, ou réglez-la sur Système pour suivre la préférence de votre système d’exploitation.

Astuces de fonctionnalités

La première fois que vous utilisez certaines fonctionnalités, Mermster affiche une brève astuce expliquant leur rôle. Les astuces apparaissent pour le navigateur de plan, le constructeur de diagrammes, l’historique des versions, les préréglages d’exportation, la palette de commandes et la minicarte du diagramme. Si vous masquez une astuce, vous pouvez la revoir en cliquant sur le bouton ? à côté de la fonctionnalité, ou en allant dans Paramètres > Astuces > Réafficher toutes les astuces.

Licences

Comment activer

1. Lors du premier export : Mermster affiche la boîte de dialogue d’activation. Saisissez votre clé de licence ou cliquez sur un bouton d’achat pour en acheter une.
2. Depuis le menu : Allez dans Aide > Activer la licence, ou ouvrez Paramètres > Licence.

Collez votre clé de licence (format : XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX) et cliquez sur Activer. L’activation nécessite une brève connexion Internet, puis votre licence fonctionne hors ligne pendant 30 jours avant de devoir être revérifiée.

Comment désactiver

Pour transférer votre licence vers un nouvel ordinateur :

1. Ouvrez Paramètres > Licence.
2. Cliquez sur Désactiver la licence.
3. Confirmez la désactivation.

Cela libère un emplacement d’appareil afin que vous puissiez l’activer sur une autre machine. Si vous désinstallez sans désactiver, contactez mermster@viaelo.app pour récupérer l’emplacement.

Raccourcis clavier

Sous Windows, remplacez Cmd par Ctrl.

Fichier

Édition

Affichage

Exporter

Questions fréquentes (FAQ)

Mermster nécessite-t-il une connexion Internet ?

Non. Mermster fonctionne entièrement hors ligne. Les seules fonctionnalités qui nécessitent Internet sont l’activation et la désactivation de la licence, ainsi que la recherche de mises à jour. La version gratuite n’a jamais besoin d’Internet.

Quels types de diagrammes Mermaid sont pris en charge ?

Tous : organigrammes, diagrammes de séquence, diagrammes de classes, diagrammes ER, diagrammes de Gantt, diagrammes d’états, cartes mentales, diagrammes circulaires, graphiques Git, chronologies, parcours utilisateur, diagrammes en quadrants, ainsi que tout nouveau type ajouté dans les futures versions de Mermaid.

Puis-je utiliser Mermster sur plusieurs appareils ?

Oui. Une licence personnelle autorise jusqu’à 5 appareils. Une licence commerciale en autorise jusqu’à 10. Vous pouvez désactiver un appareil à tout moment pour libérer un emplacement.

Mes données sont-elles envoyées quelque part ?

Non. Mermster n’a aucune télémétrie, aucune analyse ni aucun suivi. Vos diagrammes, fichiers et paramètres restent entièrement sur votre ordinateur. Les seules requêtes réseau sont la validation de la licence et la recherche de mises à jour.

Quel format de fichier Mermster utilise-t-il ?

Des fichiers texte standard .mmd et .mermaid. Ce sont du texte brut. Versionnez-les avec Git, ouvrez-les dans n’importe quel éditeur, partagez-les comme vous le souhaitez.

Puis-je utiliser la version gratuite pour un travail commercial ?

Oui. La version gratuite n’a aucune restriction de cas d’usage. Cependant, si vous partagez des diagrammes de manière professionnelle et que le filigrane n’est pas approprié, la licence Personnel (29 $) ou Commercial (59 $) le supprime.

Comment rechercher des mises à jour ?

Allez dans Aide > Rechercher des mises à jour. Mermster vous avertira si une version plus récente est disponible.

Dépannage

Avertissement Windows SmartScreen

La première fois que vous exécutez Mermster sous Windows, il se peut que vous voyiez un avertissement SmartScreen indiquant « Windows a protégé votre ordinateur ». Cela se produit parce que nous n’avons pas encore acheté de certificat de signature de code à validation étendue pour Windows. La version macOS est entièrement signée et notariée par Apple.

Pour continuer :

1. Cliquez sur Informations complémentaires dans la boîte de dialogue SmartScreen.
2. Cliquez sur Exécuter quand même.
3. Cela ne se produit qu’une seule fois. Windows mémorise votre choix.

Le diagramme ne s’affiche pas

Si l’aperçu affiche une erreur au lieu de votre diagramme :

• Vérifiez la présence de traits ondulés rouges dans l’éditeur. Ils indiquent des erreurs de syntaxe.
• Assurez-vous que votre diagramme commence par une déclaration de type valide (par exemple graph TD, sequenceDiagram, classDiagram).
• Essayez de créer un nouveau fichier à partir d’un modèle pour confirmer que l’aperçu fonctionne, puis comparez avec votre code.

L’export est flou

Si votre export PNG est flou, augmentez le réglage DPI dans la boîte de dialogue d’exportation. Utilisez 144 DPI pour les écrans Retina ou 300 DPI pour l’impression. Pour une sortie nette à n’importe quelle taille, exportez plutôt en SVG.

Échec de l’activation de la licence

• Vérifiez votre connexion Internet. L’activation nécessite une vérification en ligne unique.
• Assurez-vous de copier la clé de licence complète, tirets compris.
• Si vous avez atteint votre limite d’appareils, désactivez d’abord un appareil existant (Paramètres > Licence sur cet appareil).
• Contactez mermster@viaelo.app si le problème persiste.

J’ai perdu ma clé de licence

Envoyez un e-mail à mermster@viaelo.app avec l’adresse e-mail que vous avez utilisée pour l’achat. Nous pouvons la retrouver.

Obtenir de l’aide

Envoyez un e-mail à mermster@viaelo.app. Vous pouvez aussi nous contacter depuis l’application via Aide > Envoyer des commentaires ou Aide > Signaler un problème.