# Mermaid vers Typst

Transformez un organigramme Mermaid en diagramme fletcher modifiable pour Typst, avec une image générée quand la syntaxe n'a pas d'équivalent.

Mermaid vers Typst prend un organigramme écrit en quelques lignes de Mermaid et l'écrit sous forme de diagramme fletcher. Fletcher est un paquet Typst qui sert à dessiner des diagrammes avec des nœuds et des flèches. Les étiquettes, les formes et les flèches restent dans le code source, où vous pouvez les modifier.

## Cas d'usage

Utilisez-le pour des flux de travail de recherche, des diagrammes de méthode, des arbres de décision et d'autres organigrammes où les connexions comptent plus que le graphisme.

Pour dessiner un diagramme à la main, ou ajuster un diagramme converti sur un canevas, utilisez le [composeur de diagrammes](/docs/figures-diagrams/). Pour un document LaTeX, utilisez [Mermaid vers LaTeX](/docs/tools/mermaid-to-latex/).

## Convertir un organigramme

1. Ouvrez **Mermaid vers Typst**, ou exécutez `/mermaid-to-typst`.
2. Collez du code source Mermaid, ou choisissez **Charger un exemple**.
3. Choisissez **Convertir**.
4. Lisez la note sous le résultat. Elle indique si vous avez obtenu du code fletcher modifiable ou une image générée.
5. Copiez ou enregistrez `diagram.typ`. Quand le résultat contient une image, **Enregistrer le ZIP** garde l'image avec le code source.

Exemple :

```mermaid
flowchart LR
  question[Research question] --> search[Search literature]
  search --> decide{Enough evidence?}
  decide -->|Yes| write[Write synthesis]
  decide -.->|No| search
```

Un `flowchart` ou un `graph` en direction `TD`, `TB`, `LR`, `BT` ou `RL`, avec des étiquettes, des étiquettes d'arête, des liens en pointillés ou épais et des formes de nœud courantes, devient du code fletcher. Le résultat commence par la ligne `#import` de fletcher, suivie d'un appel `#diagram` avec un `node` par boîte et un `edge` par flèche.

## Versions de fletcher

La ligne d'import nomme une version de fletcher qui fonctionne avec votre Typst. Avec un projet Typst ouvert, Oleafly la choisit d'après la version Typst de ce projet : fletcher 0.5.8 pour Typst 0.13 et ultérieur, 0.5.5 pour Typst 0.12, et 0.5.1 pour les versions plus anciennes. Sans projet Typst ouvert, vous obtenez 0.5.8.

Typst télécharge fletcher depuis Typst Universe la première fois qu'un document qui l'utilise est compilé. Ensuite, il fonctionne hors ligne.

## Quand Oleafly génère une image à la place

Certaines syntaxes Mermaid n'ont pas de correspondance fletcher sûre : d'autres types de diagrammes comme les diagrammes de séquence, les sous-graphes, les lignes `style` et `classDef`, et les liens en chaîne comme `a --> b --> c`. Dans ce cas, Oleafly dessine le diagramme sur votre appareil, l'enregistre sous `assets/diagram.png` et renvoie un court `#figure` qui affiche cette image. Les relations restent visibles, mais l'image ne se modifie pas comme du code.

La conversion s'exécute sur votre appareil. L'entrée Mermaid est limitée à 50 000 caractères. Compilez le résultat à sa largeur définitive et vérifiez le retour à la ligne des étiquettes, les croisements et le sens des flèches.
