# Mermaid를 LaTeX로

Mermaid 순서도를 가능하면 편집 가능한 TikZ로 바꾸고, 다른 다이어그램 유형은 로컬 이미지로 대신합니다.

Mermaid를 LaTeX로 도구는 읽기 쉬운 몇 줄로 다이어그램을 시작해 논문에 싣는 데까지 이어 줍니다. 흔한 순서도는 편집 가능한 TikZ가 되므로 레이블, 선 스타일, 배치가 LaTeX 소스의 일부로 남습니다.

## 가장 알맞은 용도

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

그래프, 분야별 표기, 정밀한 수작업 구성이 들어가는 출판용 그림에는 [다이어그램 및 그림 도구](/docs/figures-diagrams/)를 대신 쓰세요. 모든 Mermaid 다이어그램 종류에 충실한 TikZ 대응물이 있으리라고 기대하지 마세요. Typst 문서에는 [Mermaid를 Typst로](/docs/tools/mermaid-to-typst/)가 fletcher 코드를 대신 써 줍니다.

## 순서도 변환하기

1. **Mermaid를 LaTeX로**를 열거나 `/mermaid-to-latex` 명령을 실행하세요.
2. Mermaid 소스를 붙여 넣거나 예시를 불러오세요.
3. **변환**을 선택하세요.
4. 결과 위의 메모를 읽고 TikZ를 받았는지, 이미지 기반 LaTeX 그림을 받았는지 확인하세요.
5. `.tex` 소스와 함께 생성된 파일을 복사하거나 저장하세요.

예시:

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

`TD`, `TB`, `BT`, `LR`, `RL` 방향에 기본 노드와 에지로 이루어진 흔한 순서도는 고정된 규칙에 따라 TikZ로 변환됩니다. 안전하게 TikZ로 옮길 수 없는 Mermaid 기능이 구문에 쓰였다면, Oleafly는 관계를 빠뜨리는 대신 다이어그램을 이 컴퓨터에서 PNG로 렌더링하고 LaTeX 그림 스니펫을 돌려줍니다.

## 그림 검토하기

최종 단 너비로 컴파일하세요. 선이 교차하는 곳, 레이블 줄바꿈, 대비, 글꼴 크기, 다이어그램의 읽는 순서를 확인하세요. 그림을 볼 수 없는 독자를 위해 설명하는 캡션이나 대체 텍스트를 추가하세요.

변환은 이 기기에서 실행됩니다. Mermaid 입력은 50,000자로 제한됩니다. 이미지 대체 방식에는 `graphicx`가 필요하고, 편집 가능한 TikZ에는 생성된 소스에 적힌 패키지가 필요합니다.