SiYuan

productivityprivacy

Privacy-first personal knowledge management system with block-level editing, bidirectional links, database views, and self-hosted sync. AGPL-licensed, free core

#notes#knowledge-base#pkm#offline#bidirectional-links#flashcards
Alternative to ObsidianNotion

Quick Start

docker run -d -v /siyuan/workspace:/siyuan/workspace -p 6806:6806 b3log/siyuan

Overview

SiYuan is a privacy-first personal knowledge management system built around the idea that your notes should live on your own hardware, not a company’s servers. It runs locally on your machine or in Docker on your own server, and everything stays offline unless you explicitly configure sync.

The editor is block-based and supports bidirectional links, database views, spaced repetition flashcards, and embedded math formulas alongside standard Markdown formatting. Backlinks, forward links, and a graph view let you visualize how ideas connect across your notes, making it useful for both day-to-day note-taking and longer-form knowledge building.

Database blocks bring spreadsheet-like functionality into notes: you can create tables with relations, rollups, and calculated fields tied to other blocks in your vault. This makes SiYuan a practical alternative to Notion for users who want data views without the cloud dependency.

The core application is free and AGPL-licensed. Sync between devices requires either self-hosting a SiYuan server via Docker or paying for the cloud sync tier. The self-hosted sync option gives you full data sovereignty with no third-party access to your notes.

With 44,000+ GitHub stars, SiYuan has built a significant following among knowledge workers who want something between Obsidian (offline-only, file-based) and Notion (cloud-only, proprietary). The main limitation is that because it uses a custom database format rather than plain Markdown files, portability requires exporting.

Use Cases

Specific ways to use SiYuan for your workflow.

01
Offline-first personal knowledge base with no cloud dependency
02
Note-taking with bidirectional links and graph visualization
03
Self-hosted sync across devices without third-party access to notes

Deployment Strategy

Recommended ways to host SiYuan in your own environment.

docker
self-hosted