Chuyển đến nội dung

siyuan-note / siyuan

SiYuan (Tư Nguyên)

Ứng dụng ghi chú theo khối, dữ liệu nằm trên máy bạn, có bản Windows, macOS, điện thoại và Docker

SiYuan là ứng dụng quản lý kiến thức cá nhân: bạn viết bằng giao diện Markdown trực quan, mỗi đoạn là một khối có thể được trích dẫn và liên kết hai chiều với khối khác. Dữ liệu nằm trong thư mục trên máy bạn, có thể tự cài trên máy chủ bằng Docker. Mã nguồn mở AGPL-3.0, phần lớn tính năng miễn phí nhưng một số tính năng dành cho thành viên trả phí.

  • 47.246 sao
  • 3.116 fork
  • TypeScript
  • Cập nhật hôm nay
  • AGPL 3.0 (chạy dịch vụ cũng phải công bố mã)
Độ khó
Dễ Cài như phần mềm thường
Dạng
Ứng dụng máy tính, Ứng dụng điện thoại
Chạy trên
Windows, macOS, Linux, Android, iOS, Docker
Chi phí
Miễn phí, có bản trả phí

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

  1. 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.

    Văn bản
    https://apps.microsoft.com/detail/9p7hpmxp73k4
  2. Cá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).

    PowerShell
    winget install --id B3log.SiYuan -e
  3. Trên macOS: nếu đã có Homebrew, bạn có thể cài nhanh bằng một lệnh trong Terminal.

    Terminal
    brew install --cask siyuan
  4. Hoặ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.

    Văn bản
    https://b3log.org/siyuan/en/download.html
  5. Giữ 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

  1. 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.

  2. Để đồ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

  1. Đặ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.

    Terminal
    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}"
  2. 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.

  3. 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

  1. 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.

  2. 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.

  3. 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.

  4. Xuất ghi chú ra PDF hoặc Word để biết đường chia sẻ cho người không dùng SiYuan.

  5. 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.

Terminal
git clone https://github.com/siyuan-note/siyuan.git

Repo tương tự nên xem

Năng suất & ghi chú45,6K

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

DễWindowsmacOSLinuxAndroid+2
Năng suất & ghi chú57,2K

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

DễWindowsmacOSLinuxAndroid+1
Năng suất & ghi chú39K

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ộ

DễWindowsmacOSLinuxDocker+1

Nội dung được biên soạn bằng tiếng Việt dựa trên tài liệu chính thức của dự án, cập nhật lần cuối 16/11/2026. Lệnh cài có thể thay đổi theo phiên bản mới; nếu có khác biệt, hãy làm theo README trên GitHub.

Cùng chủ đề: Năng suất & ghi chú

Năng suất & ghi chú136K

Excalidraw

excalidraw / excalidraw

Bảng trắng vẽ sơ đồ phong cách nét vẽ tay, dùng ngay trên trình duyệt, miễn phí và có thể cộng tác trực tiếp

DễWebNode.js
Năng suất & ghi chú80,8K

Hoppscotch

hoppscotch / hoppscotch

Công cụ gửi và kiểm thử API ngay trên trình duyệt, nhẹ hơn Postman và có thể tự cài trên máy chủ riêng

VừaWebWindowsmacOSLinux+1
Năng suất & ghi chú79K

AppFlowy

AppFlowy-IO / AppFlowy

Không gian làm việc kiểu Notion mã nguồn mở: ghi chú, tài liệu, bảng dữ liệu, bạn giữ quyền với dữ liệu

DễWindowsmacOSLinuxAndroid+1
Năng suất & ghi chú74,6K

AFFiNE

toeverything / AFFiNE

Không gian làm việc gộp tài liệu, bảng trắng và bảng dữ liệu, ưu tiên lưu trên máy và có thể tự cài

VừaWindowsmacOSLinuxWeb+1
Năng suất & ghi chú65,5K

NocoDB

nocodb / nocodb

Biến cơ sở dữ liệu thành bảng tính kiểu Airtable: xem, lọc, nhập liệu và chia sẻ mà không cần viết code

VừaDockerWeb
Năng suất & ghi chú64,5K

Memos

usememos / memos

Sổ ghi chú nhanh tự cài trên máy chủ của bạn, ghi chú theo dòng thời gian, hỗ trợ Markdown và thẻ

VừaDockerWebLinuxmacOS+1

Xem cả 18 repo Năng suất & ghi chú Về Kho Repo