Exporter un diagramme Mermaid d’un document Markdown en PDF

Votre document Markdown contient un bloc Mermaid, un tableau, parfois une formule. Marko l’affiche rendu sur votre Mac et l’exporte en PDF paginé, diagramme compris. Le but tient en une phrase : sortir proprement un document Markdown qui contient un schéma.

Ce que Marko sait rendre

Marko reste un éditeur Markdown, pas un atelier de diagrammes. Il rend ce que votre document décrit, y compris les diagrammes écrits dans un bloc de code. Quand vous ouvrez un fichier avec un bloc Mermaid, Marko le transforme en image, à sa place dans le texte.

Lors d’un rendu de contrôle sur un corpus interne, les vingt diagrammes Mermaid présents ont été rendus, soit vingt sur vingt. Un graphe DOT passe de la même manière, en image. Les tableaux GFM et les formules KaTeX sont rendus eux aussi, en ligne comme en bloc.

Le diagramme vient souvent de votre IA

Claude, ChatGPT ou Codex répondent volontiers avec un bloc Mermaid quand vous demandez un schéma de flux ou une séquence. Vous récupérez du texte comme celui-ci :

```mermaid
graph TD
  A[Idée] --> B[Brief]
  B --> C[Relecture]
  C --> D[Export PDF]
```

Collé dans un éditeur de texte simple, ce bloc reste du code. Dans Marko, vous le collez en mode Source, vous passez en mode Visuel, et le schéma s’affiche. Vous corrigez un libellé si besoin, puis vous exportez.

Préparer et exporter le document

1. Dans Marko, ouvrez votre fichier .md ou créez un document.
2. Écrivez ou collez un bloc de code Mermaid avec votre diagramme, et ajoutez un tableau si votre document en a un.
3. Passez en mode Visuel : le diagramme s’affiche en image, le tableau prend sa forme.
4. Dans le menu Fichier, choisissez « Exporter en PDF… », nommez le fichier et validez.

Le PDF est paginé au format A4, avec un numéro « n / N » en pied de page. Le diagramme Mermaid et le tableau se retrouvent dans le document exporté.

Un exemple pour essayer

Vous pouvez télécharger le brief d’exemple pour voir le parcours d’export. Ce brief contient un tableau, mais pas de bloc Mermaid. Pour tester le rendu d’un schéma, ouvrez un de vos documents qui en contient un, ou collez dans le brief le bloc que votre IA vous a renvoyé avant d’exporter.

Un document, plusieurs types de blocs

Une spec réunit souvent un schéma de flux, un tableau de responsables et une formule. Marko rend les trois dans le même document : le diagramme Mermaid en image, le tableau GFM, la formule KaTeX en ligne ou en bloc. L’export reprend l’ensemble sur les mêmes pages, sans que vous ayez à sortir chaque élément à part.

Le rendu et l’export se font sur votre Mac. Le fichier n’est pas envoyé à un service pour produire l’image du diagramme ou le PDF.

Ce que le PDF conserve

Les limites à connaître

• Marko tourne sur Mac Apple Silicon, macOS 12 ou plus récent. Les versions Mac Intel, Windows et Linux ne sont pas distribuées pour l’instant.
• Le PDF n’est pas balisé : il convient à la lecture et à l’impression, pas à un lecteur d’écran qui s’appuie sur la structure balisée.
• Les très gros documents sont plafonnés, de l’ordre de plusieurs milliers de blocs, pour éviter une mise en page interminable.

Si vous avez surtout besoin de garder la source, Marko écrit du Markdown ordinaire, bloc Mermaid compris, que vos collègues rouvrent dans l’éditeur de leur choix. L’essai complet dure quatorze jours, sans compte ni carte.