변환과 생성
Mermaid를 Typst로
Mermaid 순서도를 Typst용 편집 가능한 fletcher 다이어그램으로 바꾸고, 구문이 대응되지 않으면 렌더링된 이미지를 씁니다.
Mermaid를 Typst로 도구는 몇 줄의 Mermaid로 쓴 순서도를 fletcher 다이어그램으로 바꿔 줍니다. fletcher는 노드와 화살표로 다이어그램을 그리는 Typst 패키지입니다. 레이블, 도형, 화살표가 소스에 남아 있으므로 직접 편집할 수 있습니다.
가장 알맞은 용도
섹션 제목: “가장 알맞은 용도”연구 작업 흐름, 방법 다이어그램, 의사결정 트리, 그 밖에 그림보다 연결이 중요한 순서도에 쓰세요.
다이어그램을 직접 그리거나 변환된 다이어그램을 캔버스에서 조정하려면 다이어그램 작성기를 쓰세요. LaTeX 문서에는 Mermaid를 LaTeX로를 쓰세요.
순서도 변환하기
섹션 제목: “순서도 변환하기”- Mermaid를 Typst로를 열거나
/mermaid-to-typst명령을 실행하세요. - Mermaid 소스를 붙여 넣거나 예시 불러오기를 선택하세요.
- 변환을 선택하세요.
- 결과 아래의 메모를 읽으세요. 편집 가능한 fletcher 코드를 받았는지, 렌더링된 이미지를 받았는지 알려 줍니다.
diagram.typ파일을 복사하거나 저장하세요. 결과에 이미지가 포함되어 있으면 ZIP 저장이 이미지를 소스와 함께 보관합니다.
예시:
flowchart LR question[Research question] --> search[Search literature] search --> decide{Enough evidence?} decide -->|Yes| write[Write synthesis] decide -.->|No| searchTD, TB, LR, BT, RL 방향으로 진행하는 flowchart 또는 graph는 레이블, 에지 레이블, 점선이나 굵은 링크, 흔한 노드 모양까지 포함해 fletcher 코드가 됩니다. 결과는 fletcher용 #import 줄로 시작하고, 이어서 상자마다 node 하나, 화살표마다 edge 하나를 둔 #diagram 호출이 나옵니다.
fletcher 버전
섹션 제목: “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가 대신 이미지를 렌더링할 때
섹션 제목: “Oleafly가 대신 이미지를 렌더링할 때”일부 Mermaid 구문은 안전하게 fletcher로 옮길 수 없습니다. 시퀀스 다이어그램 같은 다른 다이어그램 유형, 서브그래프, style과 classDef 줄, a --> b --> c 같은 연쇄 링크가 그렇습니다. 이때는 Oleafly가 이 기기에서 다이어그램을 그려 assets/diagram.png로 저장하고, 그 이미지를 보여 주는 짧은 #figure를 돌려줍니다. 관계는 그대로 보이지만 이미지는 코드로 편집할 수 없습니다.
변환은 이 기기에서 실행됩니다. Mermaid 입력은 50,000자로 제한됩니다. 결과를 최종 너비로 컴파일하고 레이블 줄바꿈, 선 교차, 화살표 방향을 확인하세요.