Bottom Line: SiYuan is a formidable, local-first alternative to Notion that trades cloud convenience for total data sovereignty and granular, block-level power. It’s the ultimate "second brain" for those who prioritize privacy and structural depth over mindless ease of use.
To understand SiYuan, one must first grasp its obsession with the Block. While Notion popularized the block-based interface, SiYuan takes the concept to its logical, technical extreme. Most users are accustomed to the "page" as the fundamental unit of organization. In SiYuan, the page is merely a container for blocks. This distinction is critical. Because every block has a persistent ID, you can reference a specific sentence from a three-year-old journal entry inside a new research paper. Change the source, and the reference updates. This isn't just "linking"; it’s knowledge refactoring.
The Logic of the Web
The utility of SiYuan’s bidirectional linking cannot be overstated. When you link two concepts, the app creates a visible bridge in both directions. This allows for a "backlink" view that shows every instance where a particular topic has been mentioned. For a researcher managing thousands of data points, this transforms a collection of files into a living, breathing knowledge graph. The inclusion of a SQL-like query system further elevates this. You can generate dynamic lists—for example, "show me all blocks tagged #todo from the last 7 days that are nested under the 'Project X' hierarchy"—directly within a document. This level of automation usually requires complex plugins in other apps; here, it is baked into the foundation.
Productivity as a System
The integration of PDF annotation and spaced repetition (Anki-style flashcards) reveals SiYuan’s true ambition: it wants to be the only tool you use for the entire learning lifecycle. You can highlight a passage in a PDF, and that highlight becomes a block that you can drag into a note. That note can then be transformed into a flashcard for review. It’s a closed-loop system that eliminates the "onboarding friction" typically found when moving data between disparate apps like Readwise, Anki, and Evernote.
The Complexity Penalty
However, this power comes with a significant learning curve. SiYuan is not an app you "pick up and play." The interface, while clean, is dense with options. Understanding the difference between a block reference and a block embed, or learning the syntax for attributes and queries, requires a level of commitment that the average user might find off-putting. Furthermore, SiYuan uses a custom internal file format (JSON-based) to maintain its block IDs. While you can export to standard Markdown, the "native" experience is tied to this specific structure. This creates a minor paradox for a privacy-focused app: you own your data, but that data is most useful within the specific confines of SiYuan's engine.