Comment gérer vos projets avec Markdown et les diagrammes de Gantt de Mermaid

Gérer vos projets avec Markdown et Gantt Mermaid

Les outils de gestion de projet sont pratiques, mais ils sont payants chaque mois, vos données restent enfermées dans le service, et personne ne sait si ce service existera encore dans quelques années.

Les fichiers texte, eux, s’ouvriront encore dans 30 ans. Cet article vous montre comment suivre l’avancement d’un projet avec seulement Markdown et Mermaid.

Pourquoi gérer vos projets en texte brut

  • Il s’ouvre dans n’importe quel éditeur. Vous n’êtes lié à aucune app en particulier
  • Les différences sont visibles. Placez vos fichiers dans Git, et vous savez qui a modifié quoi, et quand
  • Il se recherche facilement. Finder ou grep : il fonctionne comme n’importe quel fichier ordinaire
  • Il est facile à confier à l’IA. Aujourd’hui, c’est le plus grand avantage de tous (nous y reviendrons plus bas)

Écrire un diagramme de Gantt avec Mermaid

Mermaid est une syntaxe qui permet de dessiner des diagrammes avec du texte. Vous l’écrivez dans un bloc de code Markdown marqué mermaid.

```mermaid
gantt
title Refonte du site web
dateFormat YYYY-MM-DD
axisFormat %m/%d
excludes weekends

section Préparation
Recueil des besoins :done, req, 2026-09-01, 5d
Orientation du design :done, des, after req, 4d

section Réalisation
Page d’accueil :active, top, 2026-09-12, 7d
Pages intérieures : sub, after top, 10d

section Lancement
Revue interne :crit, rev, after sub, 3d
Mise en ligne :milestone, m1, after rev, 0d
```

Il n’y a pas grand-chose à retenir.

SyntaxeSignification
dateFormat YYYY-MM-DDFormat des dates (à déclarer en premier)
section NomRegroupe les tâches par phase
:done,Tâche terminée (grise)
:active,Tâche en cours (couleur plus foncée)
:crit,Tâche critique (rouge)
:milestone,Repère en forme de losange pour une échéance
after reqCommence après la fin d’une autre tâche (ID req)
5d / 2wDurée (jours, semaines)
excludes weekendsExclut les samedis et dimanches du décompte des jours

Les pièges courants

  • Si vous oubliez dateFormat, les dates ne sont pas interprétées
  • Un : dans le nom d’une tâche provoque une erreur
  • after fait référence à l’ID, et non au nom de la tâche (req, top, etc. dans l’exemple ci-dessus)

Une routine simple pour suivre l’avancement

Les routines trop élaborées ne durent pas. Ces trois habitudes suffisent.

  1. Une note de synthèse par projet. L’objectif, les personnes impliquées, l’état d’avancement, les prochaines étapes et le diagramme de Gantt
  2. Une seule mise à jour par semaine. Remplacez :active par :done et corrigez les dates des tâches qui ont pris du retard. Cela prend cinq minutes
  3. Les petites tâches sous forme de listes de contrôle. Écrivez-les comme - [ ] Envoyer le brouillon, et vous voyez d’un coup d’œil ce qui reste à faire

Le diagramme de Gantt sert à voir la forme d’ensemble ; la gestion des tâches au jour le jour, c’est le rôle de la liste de contrôle. Pouvoir garder les deux dans un seul fichier, voilà ce qui fait fonctionner cette approche.

Où afficher les diagrammes

Mermaid s’affiche tel quel dans le Markdown de GitHub et de GitLab. Pour le voir pendant que vous écrivez sur votre propre Mac, il vous faut un éditeur compatible avec Mermaid.

  • Markdocx intègre Mermaid, et le rendu se fait entièrement sur votre Mac. Une seule app vous mène jusqu’à l’exportation du document fini en Word ou en PDF
  • Orviss inclut d’emblée un diagramme de Gantt dans son modèle « Vue d’ensemble du projet ». Il suffit d’ajouter des lignes pour commencer à suivre l’avancement

Confiez la lecture à un agent IA

C’est là que la gestion en texte prend tout son intérêt.

Les agents IA comme Claude Code, Codex et Cursor peuvent lire et écrire les fichiers d’un dossier. Si vos documents de projet sont de simples fichiers Markdown sur votre disque local, il suffit d’indiquer ce dossier à l’agent, et des demandes comme celles-ci

  • « Résumez en cinq lignes où en est ce projet »
  • « Reprenez les tâches non terminées dans les notes de la réunion de la semaine dernière et ajoutez-les à la liste de contrôle »
  • « Nous avons trois jours de retard : recalculez les dates du diagramme de Gantt »

fonctionnent, tout simplement. Aucune intégration à configurer, aucune clé d’API. Votre dossier de projet devient le cerveau externe de l’IA.

Orviss est une app conçue pour cette façon de travailler. Dans les dossiers de projet et les dossiers par date, vous pouvez regrouper non seulement des notes Markdown, mais aussi des fichiers ordinaires, des pages web et des e-mails. Tout est constitué de simples fichiers locaux : les modifications faites par l’agent apparaissent immédiatement à l’écran. La version Mac est disponible dès maintenant, et les versions iPhone et iPad arrivent bientôt.

→ En savoir plus sur Orviss

En résumé

  • Le gantt de Mermaid est une syntaxe simple, avec moins de 10 éléments à retenir
  • Une note de synthèse et une mise à jour hebdomadaire suffisent pour assurer le suivi de l’avancement
  • Garder vos documents en texte permet de les confier directement à un agent IA comme contexte

Plus d’articles sur Orviss