Who SiYuan is for#
Researchers building a private knowledge graph
Use block references, PDFs, flashcards, and queries to connect long-running research notes.
Skip if:
You want the simplest possible folder of Markdown files.
Self-hosters replacing Notion for personal PKM
Run a richer knowledge system with local or self-controlled sync options.
Skip if:
You need polished real-time team collaboration more than personal knowledge depth.
The problem it solves#
Hosted knowledge tools make notes convenient, but they also centralize private research, documents, and personal workflows in someone else’s workspace. Power users who rely on backlinks, PDFs, flashcards, and structured queries need a local-first system that still supports rich editing.
How it solves it#
Block-level knowledge graph
SiYuan supports block references, embeds, and two-way links, giving PKM users a more granular model than page-only notes.
Markdown WYSIWYG editor
The editor keeps Markdown compatibility while supporting outlines, block zoom, math, charts, flowcharts, and large documents.
Self-controlled sync options
Docker deployment, WebDAV, and S3 support help users keep notes under their own storage plan.
Strengths and trade-offs#
Strengths
- More structured than plain Markdown notesSiYuan combines Markdown with block references, SQL query embeds, flashcards, and PDF annotation.
- Privacy-first personal knowledge baseThe local and self-hosted options fit users who do not want a hosted workspace to own their knowledge graph.
Trade-offs
- -More complex than Obsidian for simple notesSiYuan’s block model and feature set can feel heavy if you only want Markdown files and folders.
- -Some capabilities require paid membershipThe README says most features are free but some features are paid, so users should check membership boundaries.
SiYuan vs alternatives#
SiYuan vs Notion and Obsidian
SiYuan is better when block-level references, local storage, Docker deployment, and privacy-first knowledge management matter. Notion is stronger for hosted team workspaces, while Obsidian is simpler for local Markdown vaults and plugin-heavy personal notes. SiYuan fits users who want granular blocks plus self-controlled sync options.
What it's built on#
- Languages
- GoJavaScriptTypeScript
- Tooling
- Webpack
FAQ#
Can SiYuan replace Notion?
SiYuan can replace Notion for personal knowledge management when block references, local control, and privacy matter. Notion is stronger for hosted team workspaces.
How is SiYuan different from Obsidian?
SiYuan has a block-based model, WYSIWYG editing, SQL query embeds, flashcards, and built-in PDF annotation. Obsidian is simpler for Markdown vaults and plugin-driven workflows.
Can SiYuan be self-hosted?
Yes. The README lists Docker deployment and self-controlled sync options such as WebDAV and S3.
Similar open-source tools#
Logseq
Privacy-first knowledge base with outliner and graph view
Trilium.cc
Self-hosted hierarchical notes with backlinks and encrypted sync
Orgnise
Centralize wikis, docs, and project tasks in a self-hosted workspace.
Tolaria
Organize your notes with Markdown and Git integration
Notesnook
End-to-end encrypted open source note-taking, cross-platform
AFFiNE
Local-first workspace combining docs, whiteboards, and notes