SiYuan

The current productivity market is saturated with cloud-dependent tools that prioritize convenience over data ownership. SiYuan, developed by Yunnan Liandi Technology Co., Ltd., enters this arena not as another lightweight note-taker, but as a direct challenge to the dominance of platforms like Notion and Obsidian. It positions itself as a privacy-first personal knowledge management (PKM) system, and the “privacy” label here isn’t mere marketing window-dressing. This is a tool built for the digital architect—the power user who demands that their data remain local, encrypted, and entirely under their control.

SiYuan operates on a block-level architecture. In most editors, a document is a single, static file. In SiYuan, every paragraph, image, and list item is a discrete block with its own unique identity. This granularity allows users to “refactor their thinking” by embedding, referencing, or linking specific fragments of information across an entire library without duplicating data. It’s an offline-first ecosystem; while it offers robust end-to-end encrypted (E2EE) synchronization for multi-device workflows, the primary source of truth always lives on your hardware.

Targeting researchers, developers, and high-level knowledge workers, SiYuan bridges the gap between the aesthetic fluidity of a real-time Markdown editor like Typora and the relational complexity of a SQL-backed database. It is about constructing a persistent, interconnected web of logic, not just recording information. By refusing to compromise on data sovereignty, SiYuan secures a unique niche for users who have outgrown the limitations of linear notes and are wary of the “rent-your-data” model of modern SaaS.

• Block-Level Granularity: Every element—from a single line of text to a complex table—is a discrete block. This allows for precise bidirectional linking and embedding, making the “refactoring” of ideas a structural reality rather than a metaphor.
• Local-First & E2EE Sync: Data is stored locally by default. For those needing mobility, the platform supports end-to-end encrypted synchronization via S3, WebDAV, or their proprietary cloud, ensuring your “second brain” is never exposed to third-party prying.
• Integrated Research Suite: Beyond simple notes, the app includes native PDF annotation, a SQL-like query system for dynamic data filtering, and built-in spaced repetition flashcards to turn notes into long-term knowledge.

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 is knowledge refactoring, not just “linking”.

The Logic of the Web

The utility of SiYuan’s bidirectional linking is central to its design. 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 deepens this further. 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.

Visually, SiYuan adopts a Markdown WYSIWYG (What You See Is What You Get) approach. It closely mirrors Typora’s model; as soon as you finish typing a Markdown command, the syntax disappears, leaving you with a clean, formatted document. It’s an elegant solution that avoids the cluttered “split-screen” view of older editors.

Performance is where the local-first philosophy should shine. Because the app isn’t constantly fetching data from a remote server, the design minimizes network latency by construction, and a 2D text-and-block tool of this scope is light on hardware. The UI design is utilitarian but polished, favoring a professional “IDE” aesthetic over the bubbly, consumer-grade look of modern web apps.

On Android, SiYuan faces the inherent challenge of cramming a high-density power tool onto a small screen. Manipulating blocks with a finger is naturally less precise than with a mouse. However, the mobile port appears thoughtfully designed: the “block menu” is accessible via gestures, and the sync architecture carries over from the desktop build. For users who do the bulk of their “heavy lifting” on a desktop but need to capture ideas or review flashcards on the go, the Android app is built to work effectively as a mobile satellite to the main system.

SiYuan is a sophisticated, uncompromising piece of software. It doesn’t hold your hand, and it doesn’t care about being the “easiest” app on the market. Instead, it offers a level of structural integrity and privacy that is increasingly rare in the digital age. We rate it highly and recommend it to anyone willing to invest the time to learn its idiosyncrasies — with the caveat that the learning curve and format lock-in are genuine reservations, not footnotes. For the right user, it delivers a knowledge management system that is more private and more structurally powerful than almost anything else currently available.