Converter e criar
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
Seção intitulada “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. Para um documento LaTeX, use o Mermaid para LaTeX.
Converter um fluxograma
Seção intitulada “Converter um fluxograma”- Abra o Mermaid para Typst ou execute
/mermaid-to-typst. - Cole o código-fonte Mermaid ou escolha Carregar exemplo.
- Escolha Converter.
- Leia a nota abaixo do resultado. Ela indica se você recebeu código fletcher editável ou uma imagem renderizada.
- 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:
flowchart LR question[Research question] --> search[Search literature] search --> decide{Enough evidence?} decide -->|Yes| write[Write synthesis] decide -.->|No| searchUm 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
Seção intitulada “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
Seção intitulada “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.