Un lecteur Markdown pour Macqui dessine les diagrammes Mermaid.
Écrivez un diagramme sous forme de texte dans un bloc de code marqué mermaid, et DotMD le dessine dans la page. Rien ne quitte votre Mac : cela fonctionne hors ligne, en thème clair ou sombre.
macOS 14 ou ultérieur. La lecture est gratuite ; l’édition et les relectures se paient en une fois.
Réponse rapide
DotMD est un lecteur Markdown pour Mac qui prend en charge Mermaid. Un bloc de code marqué mermaid est dessiné comme un organigramme, un diagramme de séquence, de classes, d’états ou entité-relation, un diagramme de Gantt, un camembert, une carte mentale, une frise chronologique ou un graphe git, hors ligne et aux couleurs de votre thème. L’affichage est gratuit ; l’écriture avec aperçu en direct est incluse dans DotMD Editor.
Quels diagrammes Mermaid DotMD dessine-t-il ?
DotMD intègre Mermaid 10.9. Il dessine ces types de diagrammes, et l’éditeur propose un modèle prêt à l’emploi pour chacun :
- Organigrammes et diagrammes d’états : étapes, décisions et transitions.
- Diagrammes de séquence : qui envoie quoi à qui, dans l’ordre.
- Diagrammes de classes et diagrammes entité-relation : types, tables et leurs liens.
- Diagrammes de Gantt et frises chronologiques : plans et événements dans le temps.
- Camemberts, cartes mentales et graphes git.
Un diagramme reste du texte dans votre fichier .md : il se modifie facilement, et chaque changement apparaît dans l’historique des versions.
Comment afficher Mermaid dans un fichier Markdown sur Mac
Un bloc de code marqué mermaid devient un diagramme dans la page au lieu d’afficher son code source.
-
Ouvrez le fichier
Appuyez sur ⌘O et choisissez le fichier .md ou son dossier, ou faites-le glisser sur DotMD. Chaque diagramme est dessiné à l’ouverture de la page.
-
Regardez de plus près
Cliquez sur un diagramme pour le voir en grand au-dessus de la page. Pincez pour zoomer jusqu’à 8×, faites glisser pour le déplacer, et appuyez sur Échap pour revenir.
-
Assorti au thème
Les diagrammes suivent la page : ils sont dessinés en couleurs claires ou sombres selon le thème choisi dans le menu Aa.
Écrire du Mermaid avec un aperçu en direct
L’édition fait partie de DotMD Editor. Appuyez sur Edit ou ⌘E et activez Preview (⌥⌘E) : le diagramme se redessine à côté du texte pendant la frappe, et un clic dessus saute à son code.
Insert → Diagram place dans votre fichier un exemple fonctionnel de l’un des dix types, prêt à être modifié.
Mermaid dans Quick Look, PDF et HTML
Appuyez sur la barre d’espace sur un fichier .md dans le Finder et l’aperçu montre aussi ses diagrammes : aperçu Markdown avec Quick Look.
Export as PDF… dessine les diagrammes avant de créer le PDF : Markdown en PDF sur Mac. Un fichier HTML exporté charge Mermaid depuis internet à l’ouverture.
Quand un diagramme n’apparaît pas
- Vérifiez la première ligne : elle nomme le type de diagramme, par exemple
flowchart TDousequenceDiagram. - Mettez entre guillemets,
"…", un libellé qui contient des parenthèses, des deux-points ou des guillemets. - Une erreur de syntaxe affiche le message d’erreur de Mermaid à la place du dessin.
Questions sur Mermaid sur Mac
DotMD affiche-t-il les diagrammes Mermaid hors ligne ?
Oui. Mermaid est intégré à DotMD et dessine sur votre Mac, sans connexion internet. Seul un fichier HTML exporté le charge depuis internet.
L’affichage des diagrammes Mermaid est-il gratuit ?
Oui. Lire du Markdown avec des diagrammes, les dossiers, les onglets et Quick Look sont gratuits, pour toujours. L’édition avec aperçu en direct fait partie de DotMD Editor, $14.99 une fois.
Quels diagrammes Mermaid puis-je utiliser ?
Organigrammes, diagrammes de séquence, de classes, d’états et entité-relation, diagrammes de Gantt, camemberts, cartes mentales, frises chronologiques et graphes git. L’éditeur propose un modèle pour chacun.
Comment modifier du Mermaid avec un aperçu en direct ?
Avec DotMD Editor, appuyez sur ⌘E puis sur ⌥⌘E. Le diagramme se redessine à côté du texte pendant la frappe.