Skip to content

Utilisation de mermaid-cli

Auteur : Philippe Le Van - @plv@framapiaf.org

Date : 9 octobre 2025

Introduction

Mermaid est un format qui permet de dessiner des diagrammes en texte à l’intérieur d’un fichier Markdown.

mermaid-cli est un outil qui permet de générer un schéma svg, png ou pdf à partir d’un code mermaid.

Ce document indique comment utiliser simplement mermaid-cli sur son Linux avec docker.

Installation et utilisation

Installation

Créer un fichier /usr/local/bin/mermaid-cli contenant

1
2
3
#!/bin/bash

docker run --rm -u `id -u`:`id -g` -v ./:/data minlag/mermaid-cli $@

rendre le fichier exécutable

1
sudo chmod a+x /usr/local/bin/mermaid-cli

Tester l’installation

créer un fichier mermaid d’exemple test.mmd

1
2
flowchart TD
    Start --> Stop

Et lancer la génération

1
mermaid-cli -i test.mmd -o test.pdf

Références