# Mermaid para Typst

Transforme um fluxograma Mermaid em um diagrama fletcher editável para Typst, com uma imagem renderizada quando a sintaxe não tem correspondência.

O Mermaid para Typst pega um fluxograma escrito em poucas linhas de Mermaid e o escreve como um diagrama fletcher. Fletcher é um pacote Typst para desenhar diagramas com nós e setas. Rótulos, formas e setas ficam no código-fonte, onde você pode editá-los.

## Melhor uso

Use para fluxos de trabalho de pesquisa, diagramas de método, árvores de decisão e outros fluxogramas em que as conexões importam mais do que o desenho.

Para desenhar um diagrama à mão, ou ajustar em uma tela um diagrama convertido, use o [compositor de diagramas](/docs/figures-diagrams/). Para um documento LaTeX, use o [Mermaid para LaTeX](/docs/tools/mermaid-to-latex/).

## Converter um fluxograma

1. Abra o **Mermaid para Typst** ou execute `/mermaid-to-typst`.
2. Cole o código-fonte Mermaid ou escolha **Carregar exemplo**.
3. Escolha **Converter**.
4. Leia a nota abaixo do resultado. Ela indica se você recebeu código fletcher editável ou uma imagem renderizada.
5. Copie ou salve `diagram.typ`. Quando o resultado inclui uma imagem, o **Salvar ZIP** mantém a imagem junto com o código-fonte.

Exemplo:

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

Um `flowchart` ou `graph` com direção `TD`, `TB`, `LR`, `BT` ou `RL`, com rótulos, rótulos de arestas, links tracejados ou grossos e formas comuns de nós, torna-se código fletcher. O resultado começa com a linha `#import` do fletcher, seguida por uma chamada `#diagram` com um `node` por caixa e um `edge` por seta.

## Versões do fletcher

A linha de importação indica uma versão do fletcher que funciona no seu Typst. Com um projeto Typst aberto, o Oleafly a escolhe com base na versão do Typst desse projeto: fletcher 0.5.8 para Typst 0.13 e posteriores, 0.5.5 para Typst 0.12 e 0.5.1 para versões mais antigas. Sem um projeto Typst aberto, você recebe a 0.5.8.

O Typst baixa o fletcher do Typst Universe na primeira vez que um documento que o usa é compilado. Depois disso, ele funciona offline.

## Quando o Oleafly renderiza uma imagem

Parte da sintaxe do Mermaid não tem mapeamento seguro para fletcher: outros tipos de diagrama, como diagramas de sequência, subgrafos, linhas `style` e `classDef`, e links encadeados como `a --> b --> c`. Nesses casos, o Oleafly desenha o diagrama no seu dispositivo, salva-o como `assets/diagram.png` e devolve um `#figure` curto que exibe essa imagem. As relações continuam visíveis, mas a imagem não é editável como código.

A conversão acontece no seu dispositivo. A entrada Mermaid é limitada a 50.000 caracteres. Compile o resultado na largura final e verifique a quebra de rótulos, os cruzamentos e a direção das setas.
