# Mermaid를 Typst로

Mermaid 순서도를 Typst용 편집 가능한 fletcher 다이어그램으로 바꾸고, 구문이 대응되지 않으면 렌더링된 이미지를 씁니다.

Mermaid를 Typst로 도구는 몇 줄의 Mermaid로 쓴 순서도를 fletcher 다이어그램으로 바꿔 줍니다. fletcher는 노드와 화살표로 다이어그램을 그리는 Typst 패키지입니다. 레이블, 도형, 화살표가 소스에 남아 있으므로 직접 편집할 수 있습니다.

## 가장 알맞은 용도

연구 작업 흐름, 방법 다이어그램, 의사결정 트리, 그 밖에 그림보다 연결이 중요한 순서도에 쓰세요.

다이어그램을 직접 그리거나 변환된 다이어그램을 캔버스에서 조정하려면 [다이어그램 작성기](/docs/figures-diagrams/)를 쓰세요. LaTeX 문서에는 [Mermaid를 LaTeX로](/docs/tools/mermaid-to-latex/)를 쓰세요.

## 순서도 변환하기

1. **Mermaid를 Typst로**를 열거나 `/mermaid-to-typst` 명령을 실행하세요.
2. Mermaid 소스를 붙여 넣거나 **예시 불러오기**를 선택하세요.
3. **변환**을 선택하세요.
4. 결과 아래의 메모를 읽으세요. 편집 가능한 fletcher 코드를 받았는지, 렌더링된 이미지를 받았는지 알려 줍니다.
5. `diagram.typ` 파일을 복사하거나 저장하세요. 결과에 이미지가 포함되어 있으면 **ZIP 저장**이 이미지를 소스와 함께 보관합니다.

예시:

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

`TD`, `TB`, `LR`, `BT`, `RL` 방향으로 진행하는 `flowchart` 또는 `graph`는 레이블, 에지 레이블, 점선이나 굵은 링크, 흔한 노드 모양까지 포함해 fletcher 코드가 됩니다. 결과는 fletcher용 `#import` 줄로 시작하고, 이어서 상자마다 `node` 하나, 화살표마다 `edge` 하나를 둔 `#diagram` 호출이 나옵니다.

## fletcher 버전

fletcher를 가져오는 import 줄에는 사용 중인 Typst에서 동작하는 fletcher 버전이 적힙니다. Typst 프로젝트가 열려 있으면 Oleafly가 그 프로젝트의 Typst 버전에 맞춰 고릅니다. Typst 0.13 이상에는 fletcher 0.5.8, Typst 0.12에는 0.5.5, 그보다 오래된 버전에는 0.5.1입니다. Typst 프로젝트가 열려 있지 않으면 0.5.8을 받습니다.

fletcher를 쓰는 문서를 처음 컴파일할 때 Typst가 Typst Universe에서 fletcher를 내려받습니다. 그 뒤로는 오프라인에서도 동작합니다.

## Oleafly가 대신 이미지를 렌더링할 때

일부 Mermaid 구문은 안전하게 fletcher로 옮길 수 없습니다. 시퀀스 다이어그램 같은 다른 다이어그램 유형, 서브그래프, `style`과 `classDef` 줄, `a --> b --> c` 같은 연쇄 링크가 그렇습니다. 이때는 Oleafly가 이 기기에서 다이어그램을 그려 `assets/diagram.png`로 저장하고, 그 이미지를 보여 주는 짧은 `#figure`를 돌려줍니다. 관계는 그대로 보이지만 이미지는 코드로 편집할 수 없습니다.

변환은 이 기기에서 실행됩니다. Mermaid 입력은 50,000자로 제한됩니다. 결과를 최종 너비로 컴파일하고 레이블 줄바꿈, 선 교차, 화살표 방향을 확인하세요.
