# De Mermaid a Typst

Convierte un diagrama de flujo de Mermaid en un diagrama de fletcher editable para Typst, con una imagen generada cuando la sintaxis no tiene correspondencia.

De Mermaid a Typst toma un diagrama de flujo escrito en unas pocas líneas de Mermaid y lo escribe como un diagrama de fletcher. Fletcher es un paquete de Typst para dibujar diagramas con nodos y flechas. Las etiquetas, las formas y las flechas se quedan en el código, donde puedes editarlas.

## Mejor uso

Úsalo para flujos de trabajo de investigación, diagramas de métodos, árboles de decisión y otros diagramas de flujo en los que importan más las conexiones que el dibujo.

Para dibujar un diagrama a mano, o ajustar en un lienzo uno ya convertido, usa el [compositor de diagramas](/docs/figures-diagrams/). Para un documento de LaTeX, usa [De Mermaid a LaTeX](/docs/tools/mermaid-to-latex/).

## Convierte un diagrama de flujo

1. Abre **De Mermaid a Typst** o ejecuta `/mermaid-to-typst`.
2. Pega el código de Mermaid o elige **Cargar un ejemplo**.
3. Elige **Convertir**.
4. Lee la nota que hay bajo el resultado. Indica si has obtenido código de fletcher editable o una imagen generada.
5. Copia o guarda `diagram.typ`. Cuando el resultado incluye una imagen, **Guardar el ZIP** conserva la imagen junto con el código.

Ejemplo:

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

Un `flowchart` o `graph` con dirección `TD`, `TB`, `LR`, `BT` o `RL`, con etiquetas, etiquetas de arista, enlaces discontinuos o gruesos y las formas de nodo habituales, se convierte en código de fletcher. El resultado empieza con la línea `#import` de fletcher, seguida de una llamada a `#diagram` con un `node` por cada recuadro y un `edge` por cada flecha.

## Versiones de fletcher

La línea de importación nombra una versión de fletcher que funciona con tu Typst. Con un proyecto de Typst abierto, Oleafly la elige según la versión de Typst de ese proyecto: fletcher 0.5.8 para Typst 0.13 y posteriores, 0.5.5 para Typst 0.12 y 0.5.1 para versiones anteriores. Sin ningún proyecto de Typst abierto, obtienes la 0.5.8.

Typst descarga fletcher de Typst Universe la primera vez que se compila un documento que lo usa. Después funciona sin conexión.

## Cuando Oleafly genera una imagen en su lugar

Parte de la sintaxis de Mermaid no tiene una correspondencia segura en fletcher: otros tipos de diagrama, como los diagramas de secuencia, los subgrafos, las líneas `style` y `classDef`, y los enlaces encadenados como `a --> b --> c`. En ese caso, Oleafly dibuja el diagrama en tu dispositivo, lo guarda como `assets/diagram.png` y devuelve un `#figure` breve que muestra esa imagen. Las relaciones siguen siendo visibles, pero la imagen no se puede editar como código.

La conversión se ejecuta en tu dispositivo. La entrada de Mermaid está limitada a 50 000 caracteres. Compila el resultado con su ancho final y comprueba el ajuste de las etiquetas, los cruces y la dirección de las flechas.
