# Hình & sơ đồ

Trình soạn sơ đồ: vẽ trên canvas hoặc viết mã, bằng TikZ cho LaTeX, fletcher cho Typst, hoặc Mermaid cho Markdown, kèm bản xem trước trực tiếp và mã nguồn chỉnh sửa được.

Vẽ một sơ đồ trên canvas và nhận mã nguồn thuần theo ngôn ngữ của tài liệu: TikZ cho LaTeX, sơ đồ fletcher cho Typst, hoặc lưu đồ Mermaid cho Markdown. Bản vẽ và mã luôn đồng bộ, nên bạn có thể chuyển qua lại giữa chúng ở bất kỳ lúc nào.

Trình soạn sơ đồ chạy trên thiết bị của bạn và không cần tài khoản. (Với các hình do trợ lý viết, xem [Vẽ hình bằng AI](/docs/ai-figures/).)

## Mở trình soạn sơ đồ

Từ màn hình chính, chọn **Diagram Composer** trong dock. Bạn cũng có thể chạy **Open Diagram Composer** từ bảng lệnh ⌘K (Ctrl+K), hoặc gõ `/diagram` vào thanh tìm kiếm omnibar. Một hộp thoại, **Choose a diagram composer**, hỏi sơ đồ dùng để làm gì: **TikZ diagram** cho tài liệu LaTeX, **Typst diagram** cho tài liệu Typst, hoặc **Mermaid diagram** cho tài liệu Markdown.

Từ một tài liệu đang mở, hãy chọn **Draw a diagram** trên thanh công cụ trình soạn thảo. Trình soạn bỏ qua câu hỏi và dùng luôn ngôn ngữ của tài liệu: TikZ trong tệp `.tex`, Typst trong tệp `.typ`, và Mermaid trong tệp Markdown. **Back to project** đưa bạn trở lại tài liệu.

Thanh phía trên hiển thị tên sơ đồ, bạn có thể bấm vào để đổi tên, cùng một nhãn nhỏ ghi ngôn ngữ của nó.

![Một sơ đồ TikZ được viết bằng mã, rồi chỉnh sửa dưới dạng các hình trên canvas.](https://cdn.oleafly.com/images/gifs/desktop/tikz-composer.gif?v=2)

## Vẽ trên canvas

Chế độ **Draw** là canvas. Nó hoạt động như nhau trong cả ba ngôn ngữ.

Chọn một hình khối từ bảng chọn (hình chữ nhật, hộp bo góc, hình tròn, hình elip, hình thoi, hình bình hành hoặc văn bản), rồi bấm và kéo để đặt và chỉnh kích thước của nó. **Math** và **Code** là các hộp văn bản khởi đầu với một công thức hoặc một đoạn mã mẫu theo ngôn ngữ của sơ đồ.

Để nối hai hình khối, hãy kéo từ một điểm điều khiển của hình này sang hình kia. Đường nối vẫn bám vào hai hình khi bạn di chuyển bất kỳ hình nào. Chọn đường nối để chọn đầu mũi tên (một đầu, hai đầu hoặc không có), kiểu đi đường (thẳng, vuông góc hoặc cong) và một nhãn. Chọn một hình khối để đổi nhãn, màu tô, viền, bán kính bo góc hoặc phông chữ của nó.

Các hình khối tự căn thẳng hàng khi bạn di chuyển, và hoàn tác cùng làm lại hoạt động như thường. Giữ Space và kéo để di chuyển khung nhìn, và bấm đúp vào một hình khối để sửa văn bản của nó.

![Một sơ đồ quy trình được vẽ bằng gói fletcher và biên dịch.](https://cdn.oleafly.com/images/gifs/desktop/typst-composer.gif?v=2)

## Chỉnh sửa mã

Chế độ **Code** hiển thị cùng sơ đồ đó dưới dạng mã nguồn, kèm menu **Snippets** cho các thành phần phổ biến như nút hình chữ nhật, nút hình tròn, cạnh có mũi tên và cạnh dạng đường thẳng. Sửa bên nào thì bên kia theo: di chuyển một hộp thì mã thay đổi, đổi tên một nhãn trong mã thì canvas thay đổi.

Mã nguồn là mã bình thường của từng ngôn ngữ:

- TikZ: một `tikzpicture` với các nút và cạnh.
- Typst: một đoạn fletcher hoàn chỉnh, với dòng `#import "@preview/fletcher:…"` và lời gọi `#diagram(…)` chứa các phần tử `node(…)` và `edge(…)`. Phiên bản fletcher khớp với phiên bản Typst của dự án Typst đang mở: 0.5.8 cho Typst 0.13 trở lên, 0.5.5 cho 0.12, và 0.5.1 cho các bản cũ hơn.
- Mermaid: một lưu đồ với các hình nút, liên kết có nhãn, các dòng `style` cho màu sắc, và các subgraph cho hộp nhóm. Mermaid tự bố trí sơ đồ, nên các vị trí bạn đặt trên canvas không thuộc phần mã.

### Mã mà canvas không vẽ được

Trong Typst và Mermaid, những mã mà canvas không hiển thị được giữ nguyên đúng như bạn đã viết. Với Typst, điều này gồm các lệnh import, các dòng `#let`, các khối bọc như `#figure(…)`, thiết lập sơ đồ thêm, và các vòng lặp. Với Mermaid, nó gồm các dòng `click`, chỉ thị, ghi chú (comment) và frontmatter. Một nút hoặc cạnh bạn không chạm vào trên canvas giữ nguyên văn bản của nó, và cái bạn chạm vào giữ lại các tùy chọn mà canvas không biết.

Khi canvas không hiển thị tất cả, một nút ghi chú xuất hiện trên thanh phía trên kèm số lượng, ví dụ **2 notes**. Nó liệt kê những gì chỉ còn nằm trong mã và những gì canvas hiển thị gần đúng, chẳng hạn các nút chưa đặt kích thước, nhãn có định dạng, hoặc một hình Mermaid mà canvas không có.

TikZ hành xử khác. Các ghi chú nêu tên những lệnh TikZ mà canvas không mô hình hóa, và một lần chỉnh sửa trên canvas sẽ viết lại TikZ từ bản vẽ, nên những lệnh đó bị mất. Hãy giữ các TikZ viết tay hoặc phức tạp trong chế độ Code.

## Xem trước kết quả

**Compile** tự kết xuất sơ đồ, tách khỏi tài liệu của bạn, trong một ngăn xem trước bên cạnh canvas. Chọn tỉ lệ PNG 1x, 2x hoặc 3x, và màu nền hoặc nền trong suốt.

- TikZ biên dịch bằng Tectonic trong một bản dựng riêng, nên một sơ đồ dở dang không bao giờ động đến tài liệu của bạn.
- Typst xem trước bằng chính phiên bản Typst và bộ nhớ đệm gói của dự án Typst đang mở, hoặc bằng Typst đi kèm khi không có dự án Typst nào mở. Lần xem trước Typst đầu tiên sẽ tải fletcher từ Typst Universe. Ở chế độ ngoại tuyến, hoặc khi không có kết nối, bản xem trước sẽ báo thiếu gói thay vì hiển thị một lỗi chung chung.
- Mermaid xem trước bằng trình kết xuất Mermaid riêng của ứng dụng.

Các lỗi xuất hiện trong ngăn xem trước. Với Typst và Mermaid, mỗi lỗi nêu dòng của nó trong mã, và bấm vào sẽ nhảy đến đó.

Nếu một lần biên dịch thất bại, **Fix with AI** gửi mã cùng các lỗi của nó đến nhà cung cấp AI mà bạn đã kết nối và yêu cầu mã đã sửa bằng cùng ngôn ngữ.

## Chèn, lưu và tải xuống

Biên dịch trước, rồi mở menu **Save** bên cạnh **Compile**:

- **Insert as TikZ**, **Insert as Typst** hoặc **Insert as Mermaid** đặt sơ đồ tại vị trí con trỏ trong tài liệu `.tex`, `.typ` hoặc Markdown đang mở, theo ngôn ngữ của tài liệu đó. Nếu trình soạn đang đặt ở ngôn ngữ khác, bản vẽ được chuyển đổi qua canvas trước, nên những mã mà canvas không hiển thị được sẽ không được mang theo.
- **Save to project** ghi `figures/<name>.png` và mã nguồn, `figures/<name>.tikz`, `.typ` hoặc `.mmd`, vào một dự án bạn chọn từ danh sách. Lưu vào một dự án dùng ngôn ngữ khác sẽ chuyển bản vẽ sang ngôn ngữ của dự án đó. Oleafly hỏi trước khi thay thế các tệp đã tồn tại. Thêm một sơ đồ Typst đã lưu vào tài liệu bằng `#include`, và một sơ đồ Mermaid bên trong một khối mã `mermaid`.
- **Save to project → New project** tạo một dự án sơ đồ theo ngôn ngữ của trình soạn.
- **Save Figure** giữ PNG và mã nguồn của nó trong bộ nhớ đệm hình của Oleafly, ngoài mọi dự án.

Menu **Download** lưu một PNG, một SVG cho sơ đồ Typst và Mermaid, hoặc mã nguồn dưới dạng **TikZ (.tikz)**, **Typst (.typ)** hoặc **Mermaid (.mmd)**. Tải xuống ở ngôn ngữ khác sẽ chuyển bản vẽ qua canvas.

![Một lưu đồ Mermaid được viết cho sổ tay Markdown và xem trước.](https://cdn.oleafly.com/images/gifs/desktop/mermaid-composer.gif?v=2)

## Mermaid trong tài liệu Markdown

Chèn vào một tài liệu Markdown sẽ thêm một khối mã `mermaid` được đóng khung, và bản xem trước Markdown vẽ nó. PDF cần một hình ảnh, nên trình soạn còn lưu một PNG đã kết xuất tại `figures/mermaid-<hash>.png`, và lần biên dịch Markdown đặt hình ảnh đó vào chỗ của khối. Nhờ vậy sơ đồ cũng xuất hiện trong PDF đã biên dịch. Nếu bạn sửa khối đó bằng tay sau này, PDF sẽ hiển thị mã cho đến khi bạn chèn hoặc lưu lại sơ đồ từ trình soạn.

## Mở lại và nhập sơ đồ

Các tệp mã nguồn do trình soạn lưu kết thúc bằng một dòng ghi chú giữ mô hình canvas. Nhập một trong số chúng và bản vẽ quay lại đúng như bạn để lại.

**Import diagram file** trên thanh phía trên mở một tệp `.tikz`, `.tex`, `.typ`, `.mmd` hoặc `.md` và thay thế bản nháp hiện tại. Một tệp bằng ngôn ngữ khác sẽ chuyển trình soạn sang ngôn ngữ đó. Mã mà canvas đọc được sẽ được vẽ; phần còn lại chỉ mở dưới dạng mã.

## Dự án sơ đồ

Một dự án sơ đồ chứa một hình. Tạo nó bằng bất kỳ trong ba ngôn ngữ với **Save to project → New project**. Dự án sơ đồ Typst có một tệp `main.typ` độc lập với trang được đặt kích thước theo bản vẽ, nên biên dịch nó cho ra PDF của sơ đồ.

Mở tệp chính của dự án và chuyển thanh công cụ trình soạn thảo từ **Code** sang **Canvas** (TikZ) hoặc **Visual** (Typst và Markdown) để chỉnh sửa nó trên cùng canvas đó.

Mẫu **Diagram / Figure** (TikZ) và mẫu **Typst Figure** cũng khởi tạo một dự án một hình, được viết dưới dạng mã nguồn. Các dự án như thế xem trước chính là hình đó, và [menu xuất](/docs/export/) của chúng cung cấp **Export as PDF (vector image)** và **Export as PNG**. Hãy dùng chúng cho các hình bạn tái sử dụng qua nhiều bài báo.
