# Trình soạn thảo

Viết LaTeX, Typst và Markdown với chế độ soạn thảo mã nguồn và trực quan, các công cụ tài liệu, và tệp PDF nằm ngay bên cạnh bản thảo.

Oleafly gộp việc soạn mã nguồn, điều hướng tài liệu và xem trước PDF vào một không gian làm việc. Trình soạn thảo CodeMirror của nó hỗ trợ LaTeX, Typst và Markdown. Số dòng, khớp ngoặc và tô sáng dòng hiện tại luôn bật. Dòng dài tự xuống dòng trừ khi bạn tắt **Wrap long lines** trong **Settings → Appearance → Editor**.

Các tổ hợp phím bên dưới ghi phím macOS trước; trên Windows và Linux, hãy đọc ⌘ thành Ctrl.

![LLaMA mở trong Oleafly. Cây tệp ở bên trái, mã nguồn LaTeX ở giữa, và bài báo đã biên dịch ở bên phải.](https://cdn.oleafly.com/images/screenshots/desktop/docs/llama-writing-dark-window-v2.png)

## Chọn hướng dẫn viết của bạn

Mỗi công cụ tài liệu có thanh công cụ và cú pháp nguồn riêng. Các hướng dẫn này giải thích mọi điều khiển và kèm một bản thảo bạn có thể dán vào và biên dịch:

| Công cụ | Bắt đầu từ đây |
| --- | --- |
| LaTeX | [Cấu trúc, định dạng, trích dẫn, hình, bảng, toán và điều hướng mã](/docs/writing/latex/) |
| Typst | [Tiêu đề, danh sách, định dạng, toán, hình, trích dẫn, nhãn và khối mã](/docs/writing/typst/) |
| Markdown | [Soạn mã nguồn và trực quan, định dạng Pandoc, liên kết, hình ảnh và bảng](/docs/writing/markdown/) |

## Thanh công cụ trình soạn thảo

Cả ba thanh công cụ dùng cùng một bố cục:

- **Code / Visual** đứng đầu tiên và chuyển tệp đang mở giữa mã nguồn và [soạn thảo trực quan](#visual-editing).
- **Undo** và **Redo** theo sau. Mỗi nút chuyển sang màu xám khi không còn gì để hoàn tác hoặc làm lại.
- Các nút định dạng và chèn lấp đầy phần giữa. Nút nào không vừa chỗ sẽ chuyển vào **More formatting options** (`…`) ở mọi độ rộng, nên trình soạn thảo hẹp bao giờ cũng còn đủ nút.
- Đầu bên phải giữ các công cụ tài liệu trong tầm nhìn: **LaTeX packages** hoặc **Typst packages** (xem [Gói](/docs/packages/)), [Document insights](/docs/document-insights/), [Document settings](/docs/document-settings/), **Project info**, **Find** và **Go to PDF**.

Markdown không có nút gói. Bạn cũng có thể mở các công cụ này từ bảng lệnh ⌘K: **Browse LaTeX packages**, **Browse Typst packages**, **Document insights** và **Document settings**.

## Giữ chỗ của bạn

Ngữ cảnh dính giữ cho mục hoặc môi trường bao ngoài luôn hiển thị trong lúc bạn cuộn. Trong tệp Typst, các tiêu đề phía trên con trỏ cũng được ghim theo cách tương tự. **Sticky scroll** trong **Settings → Appearance → Editor** tắt tính năng này.

Thanh breadcrumb phía trên các tệp `.tex` và `.typ` nêu tên tệp và các mục đang chứa con trỏ. Bấm vào một breadcrumb để nhảy đến tiêu đề đó. Dàn ý dự án giúp bạn di chuyển giữa các chương, còn điều hướng tham chiếu và trích dẫn đưa bạn đến mã nguồn phía sau một ký hiệu. [Tự động hoàn thiện](/docs/autocomplete/) gồm các lệnh LaTeX nhận biết gói, cách nhập toán và chi tiết trích dẫn.

Mỗi khung nhìn thanh bên ghi nhớ vị trí cuộn, thư mục đang mở rộng và các mục đang mở cho từng dự án, nên bạn quay lại đúng chỗ cũ.

![Ứng dụng chuyển sang giao diện tối, rồi sang chế độ Zen chỉ còn mã nguồn và PDF.](https://cdn.oleafly.com/images/gifs/desktop/theme-zen.gif?v=2)

## Chế độ Zen

Chế độ Zen ẩn thanh công cụ dự án, thanh bên, trợ lý, terminal, cùng các thẻ và thanh định dạng của chính trình soạn thảo. Chỉ còn bài viết của bạn, và trình soạn thảo giữ nguyên độ rộng đầy đủ.

Bấm Ctrl+⌘⇧F trên macOS hoặc Shift+F11 trên Windows và Linux để bật. Bạn cũng có thể chọn **Zen Mode** trong menu **Layout** của thanh công cụ dự án hoặc menu **View** trên macOS, hoặc chạy **Toggle Zen Mode** từ bảng lệnh ⌘K. Bấm lại phím đó, hoặc Esc hai lần, để thoát.

Trong chế độ Zen, nút **Compile** nằm ở góc trên bên phải, đè lên PDF khi PDF đang mở, và hiện khi con trỏ chuột đến gần. Một nhãn nhỏ ở đó ghi **Compiling** trong lúc dựng. Sau lần dựng thất bại nó ghi **Compile failed**, và bấm vào nó sẽ hiện hoặc ẩn nhật ký biên dịch. ⌘↵ vẫn biên dịch, và ⌘⌥P hiện hoặc ẩn PDF mà không rời chế độ Zen.

Hai tùy chọn nằm dưới [Settings → Appearance → Project](/docs/settings/appearance/#zen-mode-settings). **Go full screen** chiếm toàn màn hình trong khi chế độ Zen bật. **Show the PDF when you compile** mở PDF cạnh trình soạn thảo mỗi lần bạn biên dịch khi PDF đang ẩn. Chính phím tắt đó có thể đổi trong **Settings → Keyboard Shortcuts**.

## Giao diện, màu sắc và phông chữ

Trình soạn thảo dùng một giao diện khi ứng dụng ở chế độ sáng và một giao diện khác khi ứng dụng ở chế độ tối. Chọn cả hai, đổi màu của bất kỳ phần nào trong mã nguồn, và chọn phông chữ, cỡ chữ, khoảng cách dòng, khoảng cách ký tự và con trỏ của trình soạn thảo dưới [Settings → Appearance → Editor](/docs/settings/appearance/#editor-themes). Một [phông chữ CJK](/docs/settings/appearance/#cjk-font) riêng đặt phông cho các ký tự Trung, Nhật và Hàn, nên chữ Latin có thể giữ phông lập trình. Màu đi theo các vai có cùng ý nghĩa trong LaTeX, Typst và Markdown. Trong LaTeX, một lệnh tiêu đề và tên của nó cùng dùng màu tiêu đề, khóa trích dẫn và tên môi trường nhận màu của lệnh tương ứng, còn toán dùng một màu duy nhất. Trích dẫn Markdown như `[@key]` và `@key` được tô sáng như trích dẫn, không phải như liên kết.

## Tìm và thay thế

Bấm ⌘F để có một widget kiểu VSCode ở góc trên bên phải của trình soạn thảo:

- Các công tắc **Match case** (`Aa`), **whole word** (`ab`) và **regular expression** (`.*`)
- Bộ đếm kết quả khớp trực tiếp (`3 of 41`), với các trạng thái `No results` và `Invalid`, chặn ở `2000+` cho tài liệu khổng lồ
- Enter nhảy đến kết quả khớp tiếp theo, Shift+Enter quay về kết quả trước, Esc đóng lại
- **Select all matches** biến mọi kết quả khớp thành một con trỏ để soạn thảo đồng thời
- Mũi tên chevron mở rộng hàng **Replace**: thay kết quả tiếp theo, thay **All**, và công tắc **Preserve case** ánh xạ kiểu viết hoa của token gốc sang phần thay thế (nên thay `figure` bằng `image` cũng biến `Figure` thành `Image`)

⌘A chọn cả tệp, kể cả các dòng đã cuộn ra khỏi tầm nhìn, nên thao tác sao chép hay xóa sau đó lấy hết mọi thứ.

## Gập mã

Bấm mũi tên trong rãnh số dòng để gập.

- Trong LaTeX, một môi trường `\begin…\end` gập thành một khối (nhận biết lồng nhau), và một mục gập cho đến mục tiếp theo cùng cấp hoặc cao hơn.
- Trong Typst, một tiêu đề gập cho đến tiêu đề tiếp theo cùng cấp hoặc cao hơn. Khối mã trong `{…}`, khối nội dung trong `[…]`, danh sách tham số, phương trình, khối thô và chú thích khối cũng gập được.

Gập một chương trong khi bạn soạn thảo chương sau.

## Comment dòng mã

Bấm ⌘/ để comment hoặc bỏ comment dòng hiện tại hoặc các dòng được chọn. Dòng LaTeX nhận `%` và dòng Typst nhận `//`. Ngoài trình soạn thảo, phím này mở bảng tra tổ hợp phím tắt.

## Con trỏ nhiều và chọn khối

Trình soạn thảo hỗ trợ nhiều vùng chọn: **Alt-drag** để chọn hình chữ nhật (theo cột), và **Select all matches** trong widget tìm kiếm để có một con trỏ tại mỗi kết quả khớp. Mọi con trỏ cùng gõ, cùng xóa và cùng dán.

## Thụt lề và ngoặc

Trình soạn thảo tự thụt lề khi bạn gõ, bốn dấu cách mỗi cấp trừ khi bạn đổi **Tab size** trong **Settings → Appearance → Editor**. Tab thụt lề, hoặc chấp nhận gợi ý tự hoàn thiện đang mở. Ngoặc và dấu ngoặc kép tự đóng, backspace xóa cả cặp cùng lúc, và ngoặc tương ứng được tô sáng tại con trỏ.

## Các trợ năng gõ Typst

Tệp Typst có vài trợ năng riêng:

- Gõ `$` thì dấu `$` đóng đi kèm theo. Bấm Space bên trong cặp rỗng để biến nó thành công thức hiển thị, `$ … $`. Backspace trong một cặp rỗng xóa cả hai dấu.
- Chọn một đoạn văn bản rồi gõ `*`, `_`, `` ` `` hoặc `$` để bọc nó thành chữ đậm, chữ nghiêng, văn bản thô hoặc toán.
- Trên một mục danh sách, Enter bắt đầu mục tiếp theo với cùng dấu (`-`, `+`, `/`, hoặc một số). Shift+Enter xuống dòng mới bên trong mục, và Backspace ngay sau một dấu trống xóa dấu đó. Tab đưa mục xuống sâu thêm một cấp và Shift+Tab đưa nó ra lại.
- Gõ `/` ở đầu dòng hoặc sau một dấu cách để mở các đoạn mẫu Typst: tiêu đề, hình, hình bảng, bảng, phương trình, phương trình đánh số, chú thích cuối trang, trích dẫn, mã, mục lục, tài liệu tham khảo, ngắt trang, cột, lưới, liên kết và ba loại danh sách.
- ⇧⌥F (Shift+Alt+F) định dạng tệp bằng typstyle. Bật **Format on save** dưới **Typst** trong **Settings → Appearance → Editor** để định dạng mỗi lần bạn bấm ⌘S. Tự động lưu không bao giờ định dạng lại.

Ghép cặp `$` cần cả **Auto-close brackets** lẫn **Auto-close math**, còn bọc một vùng chọn cần **Auto-close brackets**. Cả hai công tắc nằm trong **Settings → Appearance → Editor**. Các phím danh sách luôn bật. Hoàn thiện, đổi tên, Go to definition và trợ giúp chữ ký đến từ máy chủ ngôn ngữ Typst; xem [Tự động hoàn thiện](/docs/autocomplete/) và [Code intelligence](/docs/code-intelligence/).

## Chèn hình, bảng và tham chiếu trong Typst

Typst có các công cụ chèn giống hệt LaTeX, và mỗi công cụ ghi ra mã Typst. Chúng nằm trên thanh công cụ Typst và trong menu chuột phải của trình soạn thảo:

- **Insert figure** mở hộp thoại hình. Chọn một ảnh từ dự án hoặc nhập một ảnh, rồi đặt độ rộng, chú thích, nhãn, văn bản thay thế và vị trí. Với con trỏ bên trong một `#figure` sẵn có, cùng nút đó mở **Edit figure** để bạn đổi bất kỳ thứ nào trong số đó.
- Dán hoặc thả một tệp ảnh vào trình soạn thảo. Oleafly lưu nó vào `figures/` khi dự án có thư mục đó, hoặc cạnh tài liệu chính nếu không có, rồi chèn một hình dùng tệp đó.
- **Insert table** thêm một bảng rỗng với kích thước bạn chọn. **Table from CSV/XLSX…** trong menu chuột phải nhập tệp CSV, TSV, Excel hoặc JSON, kèm chú thích và nhãn tùy chọn. Bật **Keep linked to the data file** và Oleafly sao chép dữ liệu vào thư mục `data` của dự án. Bảng đọc tệp đó ở mỗi lần biên dịch, nên khi bạn sửa dữ liệu, bảng cũng theo kịp.
- **Cite from project** ghi `@key` cho một mục trong tài liệu tham khảo của dự án. Nếu tài liệu chưa có `#bibliography`, Oleafly sẽ thêm một cái.
- **Add label** đặt nhãn lên tiêu đề, hình hoặc phương trình tại con trỏ, hoặc chọn nhãn mà nó đã có. **Insert cross-reference** liệt kê các nhãn của dự án và ghi `@label`.
- Các nút toán chèn toán nội dòng, một phương trình hiển thị, một phương trình đánh số kèm nhãn, hoặc các phương trình căn chỉnh. Nếu tài liệu chưa có quy tắc đánh số phương trình, một ghi chú đề nghị **Add rule**.
- **Symbols** chèn mỗi ký hiệu dưới tên Typst của nó.

[Viết Typst](/docs/writing/typst/) giới thiệu từng nút trên thanh công cụ.

## Soạn thảo trực quan

Mọi tệp LaTeX, Typst và Markdown đều có công tắc **Code / Visual** ở đầu thanh công cụ. Dự án mới mở ở chế độ Code, và mỗi dự án ghi nhớ chế độ bạn rời đi. Markdown còn có **Both**, hiện mã nguồn và văn bản đã định dạng chồng lên nhau hoặc cạnh nhau.

Trong LaTeX và Typst, chế độ Visual là chính trình soạn thảo đó với mã đánh dấu được vẽ tại chỗ. Đặt con trỏ vào một tiêu đề, phương trình hoặc lệnh, mã nguồn của nó hiện lại trên dòng đó. Di chuyển đi thì dạng đã dựng quay lại. Tệp vẫn là bản duy nhất, nên số dòng, gập mã, tìm và thay thế, kiểm tra chính tả và lỗi biên dịch đều tiếp tục hoạt động. Mọi nút trên thanh công cụ ghi đúng mã nguồn mà nó ghi ở chế độ Code.

Trong một tệp Typst, chế độ Visual hiển thị:

- tiêu đề, chữ đậm và chữ nghiêng, văn bản thô, liên kết và văn bản có màu
- danh sách gạch đầu dòng, danh sách đánh số và danh sách thuật ngữ với các dấu của chúng
- toán nội dòng và toán hiển thị, do Typst vẽ
- ảnh và hình, với chú thích dạng văn bản thuần
- bảng dạng lưới mà bạn có thể gõ vào. Chọn một ô và một thanh công cụ xuất hiện cho viền, căn lề, thêm hoặc xóa hàng và cột, và xóa bảng.
- tham chiếu và trích dẫn dạng con chip, còn chú thích cuối trang dạng một ký hiệu nhỏ

Các dòng `#set`, `#show`, `#import` và `#let` ở đầu tệp Typst thu gọn thành thanh **Show document settings**. Bấm vào nó để mở chúng ngay tại chỗ. Phần mở đầu LaTeX thu gọn theo cách tương tự.

Chế độ Visual phù hợp cho một lượt soát văn. Chuyển sang Code khi cần cấu trúc hoặc lệnh tùy chỉnh. Những gì chế độ Visual không vẽ được vẫn ở trên màn hình dưới dạng mã nguồn có thể soạn thảo.

## Xem trước toán

Với con trỏ nằm bên trong một phương trình, kết quả đã dựng hiện ngay phía trên nó. KaTeX vẽ toán LaTeX, và Typst vẽ toán Typst. Menu của phần xem trước có thể ẩn nó cho đến khi bạn rời phương trình, hoặc tắt hẳn. **Math preview** trong **Settings → Appearance → Editor** bật lại tính năng này.

Dán toán LaTeX vào tệp Typst, chẳng hạn `$\frac{a}{b}$` hoặc một môi trường `equation`, và nút **Paste as Typst math** xuất hiện bên dưới. Bấm vào nó để đổi phần bạn vừa dán thành toán Typst, hoặc bấm Esc để giữ LaTeX. Với toán đã có trong tệp, chọn nó rồi chọn **Convert LaTeX math to Typst** từ menu chuột phải.

## Lỗi biên dịch trong mã nguồn

Sau một lần biên dịch thất bại, mỗi lỗi được gạch chân trong tệp mà nó thuộc về. Với Typst, vết gạch phủ đúng đoạn mà Typst báo, và lỗi phát sinh bên trong một gói trỏ đến dòng trong tệp của bạn đã gọi gói đó. Di chuột lên vết gạch để đọc thông điệp. Các lỗi Typst thường gặp, như một tên chưa biết, tệp hoặc gói bị thiếu, hoặc ngoặc chưa đóng, kèm lời giải thích rõ ràng về điều gì đã sai và cần kiểm tra gì.

[Khung Logs](/docs/compiling/#reading-the-logs) liệt kê mọi lỗi kèm dòng mã nguồn tương ứng và các gợi ý của Typst.

## Trình kiểm tra LaTeX tích hợp

Trình soạn thảo kiểm tra tệp LaTeX tìm vấn đề cấu trúc ngay khi bạn gõ, trước mọi lần biên dịch:

- `\end{itemize}` không có `\begin` tương ứng, hoặc các cặp không khớp (`expected \end{figure}, got \end{table}`)
- Môi trường chưa đóng
- Khóa `\label{}` trùng lặp
- Số lẻ dấu `$` trên một dòng (gần như luôn là quên dấu phân tách toán)

Lỗi nhận đường gạch lượn màu đỏ, cảnh báo màu hổ phách, kèm các điểm đánh dấu trong rãnh số dòng. Trình kiểm tra chỉ đọc LaTeX nên không bao giờ chặn biên dịch Typst hay Markdown. Lỗi biên dịch từ lần chạy LaTeX thật xuất hiện riêng trong [khung Logs](/docs/compiling/#reading-the-logs), và [Preflight](/docs/preflight/) thêm các kiểm tra cấp mã nguồn riêng của nó ngay trong tệp.

## Đếm từ

Chạy **Word count** từ bảng lệnh ⌘K để biết số từ, số ký tự và số dòng trong tệp đang hoạt động. Tệp Typst được đếm theo quy tắc của Typst, nên mã và chú thích không lọt vào tổng.

## Phím Vim và Emacs

Chọn **Vim** hoặc **Emacs** dưới **Keybindings** trong **Settings → Appearance → Editor**, hoặc chạy **Enable vim mode** từ bảng lệnh ⌘K. Vim cho bạn `hjkl`, các toán tử và đối tượng văn bản (`dd`, `ciw`), `:w` và chế độ visual. Thay đổi áp dụng ngay, và các phím tắt Oleafly trên trang này vẫn hoạt động song song cùng nó.

## Hơn cả .tex

Tệp mở với chế độ tô sáng khớp với phần mở rộng: BibTeX, Markdown, JSON, YAML, TOML, CSS, tập lệnh shell và nhiều định dạng khác. Ảnh và PDF mở dạng xem đã dựng thay vì dạng văn bản, còn các định dạng nhị phân được bảo vệ khỏi hỏng hóc vô tình; xem [Tệp và thư mục](/docs/files/#how-different-file-types-open).

Nếu một tệp thay đổi trên đĩa trong khi bạn có chỉnh sửa chưa lưu trong đó, một biểu ngữ nêu tên tệp và đưa ra các chọn lựa **Compare**, **Keep mine** và **Reload**. Cả tệp LaTeX, Typst và Markdown đều có biểu ngữ này.

## Trang liên quan

- [Tự động hoàn thiện và lệnh slash](/docs/autocomplete/): hoàn thiện cho lệnh, tham chiếu, trích dẫn và menu chèn `/`
- [Code intelligence](/docs/code-intelligence/): nhảy đến định nghĩa, đổi tên, thẻ hover, xem trước toán
- [Kiểm tra chính tả và ngữ pháp](/docs/spellcheck-grammar/): kiểm tra ngoại tuyến bằng Hunspell và Harper hiểu rõ LaTeX
- [Gói](/docs/packages/), [Document insights](/docs/document-insights/) và [Document settings](/docs/document-settings/): các công cụ tài liệu ở phía bên phải thanh công cụ
- [Phím tắt bàn phím](/docs/keyboard-shortcuts/): tài liệu tham khảo đầy đủ
- [Chỉnh sửa AI nội dòng](/docs/ai-inline-edit/): bấm ⌘L trên một vùng chọn và mô tả thay đổi
