# Mermaid sang Typst

Biến sơ đồ luồng Mermaid thành sơ đồ fletcher chỉnh sửa được cho Typst, kèm ảnh đã kết xuất khi cú pháp không ánh xạ được.

Mermaid to Typst lấy một sơ đồ luồng viết bằng vài dòng Mermaid và viết lại dưới dạng một sơ đồ fletcher. Fletcher là một gói Typst để vẽ sơ đồ bằng các nút và mũi tên. Nhãn, hình khối và mũi tên nằm trong mã nguồn, nơi bạn có thể chỉnh sửa chúng.

## Phù hợp nhất

Dùng cho quy trình nghiên cứu, sơ đồ phương pháp, cây quyết định, và các sơ đồ luồng khác nơi các kết nối quan trọng hơn tranh vẽ.

Để vẽ sơ đồ bằng tay, hoặc điều chỉnh một sơ đồ đã chuyển đổi trên canvas, hãy dùng [trình soạn sơ đồ](/docs/figures-diagrams/). Với tài liệu LaTeX, hãy dùng [Mermaid to LaTeX](/docs/tools/mermaid-to-latex/).

## Chuyển đổi một sơ đồ luồng

1. Mở **Mermaid to Typst**, hoặc chạy `/mermaid-to-typst`.
2. Dán mã nguồn Mermaid, hoặc chọn **Load example**.
3. Chọn **Convert**.
4. Đọc ghi chú phía dưới kết quả. Nó cho biết bạn nhận được mã fletcher chỉnh sửa được hay một ảnh đã kết xuất.
5. Sao chép hoặc lưu `diagram.typ`. Khi kết quả kèm ảnh, **Save ZIP** giữ ảnh lại cùng mã nguồn.

Ví dụ:

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

Một `flowchart` hoặc `graph` chạy hướng `TD`, `TB`, `LR`, `BT` hoặc `RL`, với nhãn, nhãn cạnh, liên kết nét đứt hoặc nét đậm, và các hình nút phổ biến, sẽ thành mã fletcher. Kết quả bắt đầu bằng dòng `#import` cho fletcher, theo sau là một lệnh gọi `#diagram` với một `node` cho mỗi hộp và một `edge` cho mỗi mũi tên.

## Các phiên bản fletcher

Dòng import nêu tên một phiên bản fletcher chạy được trên Typst của bạn. Khi có một dự án Typst đang mở, Oleafly chọn phiên bản theo phiên bản Typst của dự án đó: fletcher 0.5.8 cho Typst 0.13 trở lên, 0.5.5 cho Typst 0.12, và 0.5.1 cho các bản phát hành cũ hơn. Khi không có dự án Typst nào đang mở, bạn nhận 0.5.8.

Typst tải fletcher từ Typst Universe trong lần đầu tiên một tài liệu dùng nó được biên dịch. Sau đó nó hoạt động ngoại tuyến.

## Khi Oleafly kết xuất ảnh thay thế

Một số cú pháp Mermaid không có ánh xạ fletcher an toàn: các loại sơ đồ khác như sơ đồ tuần tự, subgraph, các dòng `style` và `classDef`, và liên kết dây chuyền như `a --> b --> c`. Khi đó Oleafly vẽ sơ đồ trên thiết bị của bạn, lưu thành `assets/diagram.png`, và trả về một `#figure` ngắn hiển thị ảnh đó. Các mối quan hệ vẫn nhìn thấy được, nhưng ảnh không chỉnh sửa được như mã.

Quá trình chuyển đổi chạy trên thiết bị của bạn. Đầu vào Mermaid giới hạn 50.000 ký tự. Hãy biên dịch kết quả ở độ rộng cuối cùng và kiểm tra cách ngắt dòng nhãn, các giao nhau, và hướng mũi tên.
