Most note apps trade control for convenience; SiYuan takes the opposite approach by offering a polished, local-first workspace that keeps your data on disk while still giving modern features like block-level references and Markdown WYSIWYG. That combination makes it a practical option for people who want a personal knowledge graph and document workflow without moving everything into a vendor cloud.
What Sets It Apart
- Local-first, privacy-focused design: data lives in a workspace folder (JSON + assets), so users can host on their own machine, Docker, or self-managed server and avoid vendor lock-in. This matters if you need verifiable backups, file-system access, or strict data control.
- Block-level linking and editing: supports fine-grained block references, two-way links, and block zoom—useful for building interlinked notes, outlining ideas, and reusing content at block granularity rather than whole pages.
- Practical scalability and editor ergonomics: a WYSIWYG Markdown/Block hybrid editor optimized for large documents, multi-tab and split views, templates and snippets—so it handles both short notes and million-word documents without becoming unwieldy.
- Extensible ecosystem and integrations: plugin API, community marketplace (Bazaar), mobile apps (Android/iOS/HarmonyOS), Docker images, and an HTTP API. Built-in integrations include Tesseract OCR and AI writing/Q&A via the OpenAI API, letting you augment note-taking with OCR and generative assistance.
Who it's for — and the tradeoffs
Great fit if you want a privacy-first, flexible PKM that supports block-level knowledge work, local backups, and optional AI-assisted writing. It's especially appealing to power users who like customizing via plugins, running on Docker or a personal server, and integrating OCR or external tools.
Look elsewhere if you need seamless, multi-user cloud syncing out of the box (SiYuan discourages third-party sync disks and treats sync/cloud features carefully), require guaranteed enterprise support, or prefer a lightweight mobile-first app without a desktop/server footprint. Some convenience features (cloud storage, certain marketplace items) are gated behind membership, and the project's community and docs are more active in Chinese, so non-Chinese users may face occasional friction.
