SiYuan

Open source

A privacy-first, self-hostable personal knowledge management system with block-level references, Markdown WYSIWYG editing, flashcards and optional AI chat.

b3log.org
SiYuan homepage screenshot
GitHub stars
47k
Last 30 days
+455(+1%)
Last commit
today
Repository age
6 years
Version
v3.8.10
Licence
AGPL-3.0
Self-hosted
Yes

About SiYuan

SiYuan is an open-source, privacy-first personal knowledge management system. Its distinctive feature is fine-grained, block-level referencing: any block can be linked to or embedded elsewhere, with two-way links, custom attributes and SQL query embeds. Editing is Markdown WYSIWYG, and the project describes itself as a workspace where humans and AI agents work together. It is local-first and self-hostable.

The editor supports block-style writing, list outlines, block zoom-in, very large documents, math formulas, charts, flowcharts and Gantt charts. Web clipping, PDF annotation links, flashcards with spaced repetition, a database table view, Tesseract OCR and multi-tab split-screen layouts are included. You can export blocks and embeds, standard Markdown with assets, or PDF, Word and HTML. AI writing and Q and A chat can use the OpenAI API, and template and JavaScript or CSS snippets allow customization.

SiYuan is AGPL-3.0 licensed and available as desktop apps, mobile apps for Android, iOS and HarmonyOS, an installation package, a package manager, and Docker, Kubernetes, Unraid and TrueNAS hosting. A command line interface and an app market for extensions exist. Most features are free, even for commercial use.

Key features

  • Block-level references and two-way links
  • Markdown WYSIWYG editor
  • Flashcards with spaced repetition
  • SQL query embeds and database table views
  • Export to Markdown, PDF, Word and HTML
  • AI writing and Q and A chat
  • Docker, Kubernetes and mobile apps

Good fit for

  • Building a personal knowledge base with linked notes
  • Studying with flashcards and annotated PDFs
  • Self-hosting a private notes workspace
Tags
knowledge-management
note-taking
markdown
local-first
self-hosted
block-editor
flashcards
ai
wiki

SiYuan: questions and answers

What is SiYuan used for?
SiYuan is a privacy-first, self-hostable personal knowledge management system with block-level references, Markdown WYSIWYG editing, flashcards and optional AI chat. It is a good fit for building a personal knowledge base with linked notes, studying with flashcards and annotated PDFs, and self-hosting a private notes workspace.
Is SiYuan open source?
Yes. SiYuan is open source under the AGPL-3.0 licence. Its source code is on GitHub at siyuan-note/siyuan and is written mainly in TypeScript.
Is SiYuan free?
Yes. SiYuan is open source, so the software itself is free to use.
Can I self-host SiYuan?
Yes. SiYuan can be self-hosted on your own server or infrastructure.
What is SiYuan an alternative to?
SiYuan is an open-source alternative to Notion, Obsidian, Evernote and Microsoft OneNote. Other open-source alternatives to Notion include Logseq, Anytype and Joplin.
Is SiYuan actively maintained?
Yes. The most recent commit to SiYuan was on 16 November 2026, and the latest release is v3.8.10, published on 10 November 2026. The project has 47k stars on GitHub, with 455 added in the last 30 days.

Open-source alternatives to SiYuan

See all

SaaS alternatives to SiYuan

See all