Trải nghiệm khi dùng SiYuan (Tư Nguyên)
Bạn cài như phần mềm thường, mở lên và thấy giao diện ghi chú gồm cây thư mục bên trái và khung soạn thảo ở giữa. Gõ văn bản theo kiểu Markdown nhưng thấy kết quả ngay (WYSIWYG, tức gõ sao hiển thị vậy). Điểm khác với nhiều app ghi chú là mỗi đoạn văn, mỗi dòng trong danh sách đều là một khối riêng, có thể được tham chiếu từ ghi chú khác.
Khi bạn nhắc tới một khối ở chỗ khác, SiYuan tạo liên kết hai chiều: ở ghi chú gốc bạn thấy được nơi nào đang trích dẫn nó. Dùng một thời gian, ghi chú của bạn nối với nhau như một mạng lưới thay vì những tệp rời rạc. Với sinh viên ôn thi hay người làm nghiên cứu, cách này giúp tìm lại ý cũ rất nhanh.
Dữ liệu nằm trong một thư mục workspace trên máy bạn. README nhấn mạnh không nên đồng bộ thư mục này bằng ổ đồng bộ bên thứ ba vì có thể hỏng dữ liệu; muốn đồng bộ thì dùng cách của SiYuan, trong đó có phần cần tư cách thành viên trả phí.
Tính năng nổi bật
Trích dẫn và liên kết ở mức khối
Tham chiếu chính xác từng đoạn, nhúng nội dung của ghi chú này vào ghi chú khác và xem các liên kết hai chiều.
Soạn Markdown trực quan
Hỗ trợ công thức toán, biểu đồ, sơ đồ luồng, Gantt, kẹp trang web (web clipping) và chú thích PDF.
Xuất ra nhiều định dạng
Xuất Markdown kèm tệp đính kèm, PDF, Word và HTML để chia sẻ hoặc nộp bài.
Thẻ ghi nhớ ngắt quãng
Có sẵn flashcard ôn tập lặp lại ngắt quãng, tiện cho việc học từ vựng và kiến thức.
Nhiều nền tảng, cả Docker
Có ứng dụng cho máy tính, Android, iOS và bản Docker để truy cập qua trình duyệt từ nhiều thiết bị.
Chợ tiện ích cộng đồng
Cài thêm giao diện, plugin và đoạn mã tuỳ chỉnh; có API để lập trình viên tích hợp.
Tận dụng SiYuan (Tư Nguyên) vào việc gì?
Sinh viên, người làm luận văn
Sổ tay ôn thi và nghiên cứu
Chép ý từ giáo trình, nối các khái niệm với nhau bằng trích dẫn khối, rồi xuất ra Word hoặc PDF khi cần.
Dân văn phòng, người làm nội dung
Kho kiến thức công việc cá nhân
Gom quy trình, ý tưởng bài viết, ghi chú họp vào một nơi dữ liệu nằm ở máy bạn.
Người học ngoại ngữ
Học từ vựng bằng thẻ ghi nhớ
Biến ghi chú thành thẻ ôn tập để lặp lại đúng lúc.
Người biết dùng Docker
Trang ghi chú truy cập từ nhiều thiết bị
Cài bản Docker trên một máy chủ nhà rồi mở bằng trình duyệt từ điện thoại và máy tính.
Cần chuẩn bị gì?
- Windows, macOS hoặc Linux cho ứng dụng máy tính; Android, iOS cho điện thoại.
- Để chạy bản Docker: Docker và một thư mục workspace trên máy chủ, cộng mật khẩu khoá truy cập do bạn đặt.
- Một số tính năng như kết nối kho đám mây bên thứ ba dành cho thành viên trả phí theo trang giá của SiYuan.
- Tính năng AI cần khoá API của dịch vụ tương thích OpenAI nếu bạn muốn dùng.
Hướng dẫn cài đặt chi tiết
Cài trên Windows / macOS
Cách khuyên dùng theo README là cài qua kho ứng dụng để sau này cập nhật dễ. Trên Windows, mở Microsoft Store và tìm SiYuan, hoặc dùng liên kết chính thức trong README.
https://apps.microsoft.com/detail/9p7hpmxp73k4Cách nhanh hơn: mở PowerShell và cài bằng winget (trình quản lý ứng dụng có sẵn trên Windows 10/11).
winget install --id B3log.SiYuan -eTrên macOS: nếu đã có Homebrew, bạn có thể cài nhanh bằng một lệnh trong Terminal.
brew install --cask siyuanHoặc tải bộ cài ở trang tải chính thức của SiYuan hoặc trang Releases trên GitHub, mở file và cài như phần mềm thường.
https://b3log.org/siyuan/en/download.htmlGiữ thư mục workspace ngoài thư mục cài đặt, vì khi cập nhật SiYuan sẽ xoá file trong thư mục cài đặt.
Cài trên Điện thoại
Android: cài từ Google Play hoặc F-Droid. iOS: cài từ App Store. Tìm tên SiYuan hoặc dùng liên kết trong README của dự án.
Để đồng bộ giữa máy tính và điện thoại, dùng tính năng đồng bộ của chính SiYuan; một số lựa chọn như kho đám mây bên thứ ba cần tư cách thành viên.
Cài trên Docker
Đặt mật khẩu khoá truy cập (thay chữ trong dấu nháy bằng mật khẩu mạnh của bạn) rồi chạy container. Lệnh dưới theo README: thay workspace_dir_host bằng thư mục trên máy chủ, workspace_dir_container bằng đường dẫn trong container. Lưu ý từ bản 3.7.0 phải ghi rõ lệnh serve.
export AuthCode='your-strong-password' docker run -d \ -v workspace_dir_host:workspace_dir_container \ -p 6806:6806 \ -e PUID=1001 -e PGID=1002 \ b3log/siyuan \ serve \ --workspace=workspace_dir_container \ --accessAuthCode="${AuthCode:?Set AuthCode}"Thư mục workspace trên máy chủ phải thuộc đúng người dùng và nhóm khớp với PUID và PGID bạn đặt, nếu không SiYuan không ghi được dữ liệu.
Mở trình duyệt vào địa chỉ máy chủ ở cổng 6806 rồi nhập mật khẩu khoá truy cập.
Dùng thử lần đầu
Mở SiYuan lần đầu và để nó tạo workspace. Chọn một thư mục dễ nhớ, nằm ngoài nơi cài ứng dụng.
Tạo một sổ tay (notebook) và viết một ghi chú ngắn, thử gõ Markdown như tiêu đề và danh sách để thấy kết quả hiện ngay.
Tạo ghi chú thứ hai, trích dẫn một đoạn từ ghi chú thứ nhất bằng tham chiếu khối. Quay lại ghi chú đầu để thấy liên kết ngược.
Xuất ghi chú ra PDF hoặc Word để biết đường chia sẻ cho người không dùng SiYuan.
Mở hướng dẫn người dùng đi kèm hoặc trang tài liệu chính thức để học thêm thao tác với khối và cơ sở dữ liệu.
Mẹo dùng hay
- Đừng đặt workspace trong thư mục đang đồng bộ bằng Dropbox hay OneDrive; README cảnh báo có thể hỏng dữ liệu.
- Sao lưu thư mục workspace định kỳ, nhất là trước khi nâng cấp phiên bản lớn.
- Nếu dùng Docker, luôn đặt mật khẩu khoá truy cập; README nhấn mạnh nếu không ai cũng truy cập được dữ liệu của bạn.
Lưu ý và hạn chế
- Giấy phép AGPL-3.0: bạn dùng và sửa được, nhưng nếu chạy bản đã chỉnh cho người khác dùng qua mạng thì phải công khai mã đã sửa.
- Không phải tính năng nào cũng miễn phí; README nói một số tính năng chỉ dành cho thành viên trả phí.
- README không nêu rõ SiYuan đã có giao diện tiếng Việt hay chưa; hãy kiểm tra ngôn ngữ trong phần cài đặt của ứng dụng. Tài liệu chính thức chủ yếu bằng tiếng Anh và tiếng Trung.
Câu hỏi thường gặp
SiYuan có miễn phí không?
Theo README, phần lớn tính năng miễn phí kể cả dùng thương mại. Một số tính năng như kết nối kho đám mây bên thứ ba dành cho thành viên trả phí.
Dữ liệu của tôi nằm ở đâu?
Trong thư mục workspace trên máy bạn, hoặc trên máy chủ của bạn nếu chạy Docker. README mô tả SiYuan là ưu tiên riêng tư.
Có chuyển từ Notion hay Obsidian sang được không?
README không liệt kê đường chuyển cụ thể. SiYuan nhập và xuất Markdown, nên nhiều tệp Markdown có thể đưa qua, nhưng liên kết và định dạng đặc thù có thể cần chỉnh lại.
Tải mã nguồn về máy
Nếu bạn muốn xem hoặc sửa mã nguồn, mở Terminal (trên Windows là PowerShell) và chạy lệnh dưới. Máy cần cài sẵn Git.
git clone https://github.com/siyuan-note/siyuan.gitRepo tương tự nên xem
Logseq
logseq / logseq
Sổ tay dạng đề cương, liên kết hai chiều, dữ liệu là tệp trên máy bạn
Joplin
laurent22 / joplin
Ứng dụng ghi chú và to-do mã nguồn mở, dùng offline, đồng bộ có mã hoá, thay thế Evernote
Trilium Notes
TriliumNext / Trilium
Ứng dụng ghi chú dạng cây phân cấp cho kho kiến thức cá nhân lớn, có thể tự cài máy chủ đồng bộ