SiYuan is an open-source, local-first, privacy-first personal knowledge management app built around one idea: the content block. Notes are Markdown documents composed of blocks that support references, backlinks, embeds, and bidirectional links, with databases, flashcards, and multi-device sync layered on top. Most features are free, even for commercial use, and the kernel plus clients are published under AGPL-3.0.[1][2]
Quick verdict
SiYuan is a strong pick for local-first, block-based note-taking with backlinks, databases, and spaced repetition under an AGPL-3.0 codebase. Its free tier covers genuine personal use, but multi-device sync is a paid decision with an 8GB official cap, and server self-hosting gives up export and native clients. If you want the same linked-block workflow with plain local files, compare Logseq before committing.[1][2][3]
Key features
Every paragraph, list, document page, and embed is a content block with block-level references and two-way links, so notes connect at a finer grain than page links. Backlinks, mentions, and a global relationship graph surface those connections.[1][2]
The editor is Markdown WYSIWYG with list outlines, block zoom-in focus, and large-document handling the project describes as smooth into the millions of words. Formulas, charts, flowcharts, Gantt and timing diagrams, staves, web clipping, and PDF annotation links extend it beyond prose.[1][2]
Databases support table views with relations, rollups, and templates, so structured collections can link to each other instead of living in isolated pages.[1][2]
Built-in flashcards use the FSRS spaced-repetition algorithm to schedule reviews, making study decks a first-class citizen rather than a plugin.[1][2]
Multi-device sync is end-to-end encrypted with a user-held data-repo key. The paid subscription adds official cloud sync with 8GB of storage, and paid tiers can sync and back up through third-party S3 or WebDAV storage.[1][2][3]
AI writing and Q/A chat work through an OpenAI API connection for drafting, translation, summarising, and grammar correction, and Tesseract OCR extracts text from images.[1][2]
SiYuan runs on Windows, macOS, Linux, Android, iOS, and HarmonyOS with a Docker image for server self-hosting, publishes an HTTP API, and offers templates, JavaScript and CSS snippets, and a community marketplace of plugins, themes, and widgets.[1][2]
Who will love it
Note-takers who think in linked ideas rather than folders will like block references, backlinks, and the graph. This is an editorial inference from the documented block model, not a vendor promise about any specific workflow.[1][2]
Students and researchers combining notes with memorisation get flashcards, PDF annotation links, and databases in one workspace. This reads the documented feature set as a study workflow, which the vendor does not specifically prescribe.[1][2]
Privacy-minded individuals who want Markdown notes on their own devices, with optional self-hosted Docker sync instead of a vendor cloud, match the local-first design. Paid sync is still required for the official cloud path.[1][2]
Who should pause
Sync, cloud backup, and cloud storage are paid capabilities: local use is free, but official sync needs the subscription and third-party S3 or WebDAV sync needs a paid tier plus storage you buy and configure yourself. Official cloud storage is capped at 8GB per user.[1][2]
Do not point a third-party folder-sync disk at the workspace; the project states this is unsupported and data may be corrupted. The supported paths are official sync or the documented S3 and WebDAV integrations.[1]
The Docker server deployment is browser-only: it does not accept desktop or mobile app connections and offers no PDF, HTML, or Word export and no Markdown file import. Desktop and mobile clients are needed for the full experience.[1]
Alternatives and compatibility
Logseq is the closest like-for-like alternative: both are local-first, privacy-first, open-source block-based knowledge tools with backlinks and encrypted sync. This is an editorial competitor inference from documented function on both sides, not a vendor-endorsed comparison, and it covers personal linked-block note-taking only.[1][2][3]
SiYuan exports standard Markdown with assets plus PDF, Word, and HTML, copies to publishing platforms, and exposes an HTTP API and plugin API, so notes and workflows can leave the app through documented paths rather than lock-in.[1]
Questions worth asking
Is SiYuan free to use?
Yes. SiYuan's core note-taking features are free, including for commercial use. Paid PRO and subscription tiers add official cloud sync and backup, cloud storage, and third-party S3 and WebDAV sync integration. Refunds are not available after subscribing, so the vendor recommends trying the trial subscription first.[1][2]
Is SiYuan open source?
Yes. SiYuan's user interface and kernel are published as open source under the GNU Affero General Public License v3, with the Android, iOS, HarmonyOS, and browser-extension clients in separate public repositories. The README FAQ states the project is completely open source and welcomes contributions.[1][2]
Which platforms does SiYuan run on, and can I self-host it?
How does SiYuan store and sync notes?
Notes are stored locally in a workspace folder on your device, and sync uses end-to-end encryption with a data-repo key you control. Official cloud sync and backup come with the paid subscription, while paid tiers can also sync through S3 or WebDAV storage you provide yourself. Syncing the workspace through third-party folder-sync disks is not supported and may corrupt data.[1][2][3]
Sources and editorial review
Source research. Reviewed on October 12, 2026. Written by Sanjib Sah. AI assisted; reviewed by a human editor.
We have not run or tested this product.
- SiYuan official site
official · Observed October 10, 2026
Official English product site inspected for identity, positioning, features, sync, pricing structure, and platform coverage.
- siyuan-note/siyuan README
official · Observed October 10, 2026
Repository README inspected for feature list, AGPLv3 badge, architecture, Docker hosting, OIDC, API, distribution, storage FAQ, and open-source statement.
- SiYuan pricing
official · Observed October 10, 2026
Official pricing page inspected for free tier, PRO one-time purchase, subscription with 8GB cloud storage, and S3/WebDAV integration terms.
- SiYuan download
official · Observed October 10, 2026
Official download page inspected for v3.8.6 platform installers, app-store distribution, Docker image, and local workspace storage description.
- siyuan-note/siyuan LICENSE
official · Observed October 10, 2026
Repository LICENSE file inspected to confirm the AGPL-3.0 license text.
- siyuan-note/siyuan kernel go.mod
official · Observed October 10, 2026
Kernel go.mod inspected for Go module, SQLite, OIDC, WebDAV, FSRS, and OpenAI dependencies confirming the stack.
- Logseq homepage
official · Observed October 10, 2026
Logseq homepage inspected to confirm its privacy-first open-source knowledge-base positioning for the competitor comparison.
Compared with these products
No explicit proprietary baseline is recorded.