Trong quá trình viết nội dung học thuật hoặc tài liệu kỹ thuật, tốc độ nhập các ký hiệu toán học ảnh hưởng trực tiếp đến năng suất. SiYuan, một công cụ quản lý kiến thức cá nhân tập trung vào quyền riêng tư, tích hợp công cụ hiển thị công thức KaTeX mạnh mẽ. Với cú pháp tối giản và các tính năng nhập thông minh, việc xử lý các ký hiệu phức tạp trở nên nhanh chóng và trực quan. Bài viết này sẽ hướng dẫn chi tiết cách nhập nhanh các ký hiệu toán học trong SiYuan, từ cú pháp cơ bản đến tùy chỉnh nâng cao, giúp bạn thoát khỏi quy trình tìm kiếm ký hiệu rườm rà.
Cú pháp nền tảng: Hai chế độ công thức
SiYuan hỗ trợ hai chế độ chèn: công thức trong dòng (inline) và công thức khối (block), đáp ứng các nhu cầu định dạng khác nhau. Chế độ inline phù hợp với các ký hiệu ngắn nằm trong đoạn văn, trong khi chế độ block dùng để hiển thị các biểu thức phức tạp một cách độc lập.
Công thức trong dòng (Inline Math)
Sử dụng ký hiệu đô la $ để bao quanh nội dung công thức. Ví dụ: nhập $E=mc^2$ sẽ hiển thị thành E=mc². Chế độ này rất hữu ích khi cần chèn ký hiệu toán học vào giữa văn bản, giữ cho dòng chảy mượt mà. Về mặt kỹ thuật, SiYuan phát hiện dấu $ để kích hoạt quá trình xử lý, sử dụng lệnh katex.renderToString trong file app/src/protyle/render/mathRender.ts tại dòng 36.
Công thức khối (Math Block)
Dùng hai ký hiệu đô la $$ để tạo một khối công thức riêng biệt. Ví dụ:
$$
\sum_{i=1}^{n} i = \frac{n(n+1)}{2}
$$
Đoạn code trên sẽ hiển thị một khối công thức được căn giữa, có thể tự động đánh số. Tính năng đánh số tự động này rất tiện lợi cho các tài liệu học thuật cần tham chiếu chéo. Bạn có thể tùy chỉnh định dạng số tại cấu hình editor trong app/src/config/editor.ts (dòng 290-293).
Mẹo nhập nhanh: Bảng ký hiệu và gợi ý tự động
SiYuan cung cấp nhiều cách nhập khác nhau, từ chọn bằng chuột đến gõ phím thuần túy, giúp giảm thiểu nỗ lực ghi nhớ ký hiệu.
Bảng ký hiệu trực quan
Vào menu "Chèn" → "Công thức toán", hoặc dùng tổ hợp phím Ctrl+Shift+M (macOS: Cmd+Shift+M) để mở bảng chọn ký hiệu trực quan. Bảng này được phân loại theo chuyên ngành (đại số, hình học, giải tích,...) và hỗ trợ tìm kiếm bằng từ khóa. Nhấp vào ký hiệu mong muốn sẽ chèn code LaTeX tương ứng. Chức năng này được xử lý trong file app/src/protyle/toolbar/InlineMath.ts.
Gợi ý lệnh thông minh
Trong vùng soạn thảo, gõ /math để chèn nhanh một khối công thức, hoặc /imath để chèn công thức trong dòng. Phương pháp này phù hợp với người dùng thích thao tác bằng bàn phím, giảm sự phụ thuộc vào chuột. Các lệnh này được định nghĩa trong hằng số MENU_INLINE_MATH tại app/src/constants.ts (dòng 289).
Bảng ký hiệu thông dụng
Nắm vững các ký hiệu phổ biến dưới đây có thể tăng tốc độ nhập lên hơn 60%:
| Ký hiệu | Mã LaTeX | Ngữ cảnh sử dụng |
|---|---|---|
| α | \alpha | Chữ Hy Lạp |
| ∑ | \sum | Ký hiệu tổng |
| ∫ | \int | Ký hiệu tích phân |
| √ | \sqrt{x} | Căn bậc hai |
| ∂ | \partial | Đạo hàm riêng |
| ∈ | \in | Ký hiệu tập hợp |
| ∀ | \forall | Ký hiệu logic |
| ∞ | \infty | Ký hiệu vô cực |
Lưu ý: Các lệnh LaTeX phân biệt chữ hoa và thường. Ví dụ, \alpha (viết thường) và \Alpha (viết hoa) tạo ra hai ký hiệu khác nhau.
Tính năng nâng cao: Macro và thay thế hàng loạt
Đối với các ký hiệu chuyên ngành hoặc biểu thức phức tạp được sử dụng lặp lại, tính năng macro của KaTeX trong SiYuan cho phép "định nghĩa một lần, dùng nhiều lần", cải thiện đáng kể tính nhất quán và hiệu quả chỉnh sửa.
Định nghĩa macro tùy chỉnh
Vào "Cài đặt" → "Trình soạn thảo" → "Macro KaTeX" (theo dõi file app/src/config/editor.ts, dòng 290-293) để thêm các ánh xạ ký hiệu tùy chỉnh. Ví dụ:
{
"\\R": "\\mathbb{R}",
"\\vec": "\\overrightarrow{#1}"
}
Sau khi định nghĩa, nhập $\R$ sẽ hiển thị ký hiệu tập số thực ℝ, và nhập $\vec{AB}$ sẽ tạo ký hiệu vector $\\overrightarrow{AB}$. Macro hỗ trợ tham số (ví dụ, #1 đại diện cho tham số đầu tiên), phù hợp để tạo các mẫu phức tạp.
Thay thế ký hiệu hàng loạt
Sử dụng chức năng "Tìm kiếm và thay thế" (phím tắt Ctrl+H) để thay đổi hàng loạt ký hiệu trong tài liệu. Ví dụ, thay tất cả \delta bằng \Delta. Khi thay thế, nên bật tùy chọn "Chỉ thay thế trong công thức" để tránh ảnh hưởng đến văn bản thường. Chức năng này sử dụng biểu thức chính quy trong file app/src/protyle/util/replace.ts, được tối ưu hóa riêng cho môi trường công thức.
Xử lý sự cố thường gặp
Dù đã thành thạo các kỹ thuật nhập, đôi khi bạn vẫn gặp lỗi hiển thị hoặc chậm. Dưới đây là hướng dẫn khắc phục từ cộng đồng:
Lỗi hiển thị công thức
Khi công thức không được hiển thị mà chỉ hiện code LaTeX thô, hãy kiểm tra:
- Dấu đô la có xuất hiện theo cặp không? Thiếu một dấu sẽ gây lỗi.
- Công thức có chứa ký tự đặc biệt chưa được thoát (ví dụ,
_cần viết là\_)? - Kiểm tra bảng điều khiển (console) để xem thông báo lỗi chi tiết trong file
app/src/protyle/render/mathRender.ts(dòng 123-133).
Ký hiệu hiển thị sai vị trí
Nếu ký hiệu bị lệch hoặc không đầy đủ, thường là do vấn đề font chữ:
- Vào "Cài đặt" → "Giao diện" và chuyển sang font chữ không chân (ví dụ: "Source Han Sans").
- Xóa bộ nhớ cache của trình duyệt và khởi động lại SiYuan.
- Thay đổi đường dẫn CDN của KaTeX trong
app/src/constants.ts(dòng 20) sang máy chủ trong nước.
Tối ưu khi soạn thảo tài liệu lớn
Khi làm việc với tài liệu chứa hàng trăm công thức, có thể cải thiện hiệu suất bằng cách:
- Tắt tạm thời tính năng "Hiển thị công thức theo thời gian thực" (Cài đặt → Trình soạn thảo).
- Sử dụng chế độ chỉnh sửa theo khối, thu gọn các vùng công thức không cần chỉnh sửa.
- Nâng cấp lên SiYuan phiên bản v3.3.0 trở lên, vì phiên bản này đã tối ưu bộ nhớ đệm trong
app/src/protyle/render/mathRender.ts.
Quy trình làm việc hiệu quả: Từ nhập đến xuất
Kết hợp với các tính năng khác của SiYuan, bạn có thể xây dựng một quy trình hoàn chỉnh để tạo tài liệu toán học, từ nhập nhanh đến xuất chất lượng cao.
Kết hợp công thức với bảng biểu
Chèn công thức vào trong bảng để tạo các bảng dữ liệu kết hợp với công thức. Ví dụ:
| Công thức | Mô tả | Ứng dụng |
|---|---|---|
| $F=ma$ | Định luật 2 Newton | Cơ học cổ điển |
| $E=mc^2$ | Phương trình năng lượng | Thuyết tương đối |
SiYuan tự động nhận diện và hiển thị các công thức trong bảng nhờ logic xử lý trong file app/src/protyle/render/table.ts.
Xuất tài liệu đa định dạng
Sau khi hoàn thành, bạn có thể xuất tài liệu chứa công thức ra nhiều định dạng:
- PDF: Giữ nguyên độ chính xác của công thức, phù hợp để in ấn.
- Markdown: Giữ nguyên code LaTeX gốc, thuận tiện cho việc chỉnh sửa lại.
- HTML: Sử dụng CDN của KaTeX để tải công cụ hiển thị, phù hợp để đăng tải lên web.
Quá trình xuất xử lý các macro KaTeX trong file app/src/protyle/export/index.ts (dòng 494 và 748) để đảm bảo công thức được hiển thị đúng như khi soạn thảo.
Tài nguyên học tập bổ sung
Việc thành thạo các kỹ thuật nhập ký hiệu toán học trong SiYuan có thể giúp tăng hiệu suất viết học thuật lên ít nhất 40%. Hãy kết hợp các cú pháp cơ bản, mẹo nhập nhanh và macro để xây dựng quy trình làm việc phù hợp với bản thân.
Để nâng cao hơn nữa, bạn có thể tham khảo:
- Danh sách ký hiệu KaTeX đầy đủ: Tài liệu tham khảo chính thức.
- Thư viện mẫu công thức SiYuan: Các mẫu do cộng đồng chia sẻ.
- Hướng dẫn LaTeX cơ bản: Khóa học nhập môn về sắp chữ toán học với LaTeX.
Luyện tập thường xuyên là chìa khóa. Hãy thử thách bản thân bằng "Thử thách 10 công thức mỗi ngày" để hình thành trí nhớ cơ bắp.