SiYuan Review: blockbasierte Obsidian-Alternative für Devs

SiYuan-Rezension: Eine blockbasierte Obsidian-Alternative für Entwickler

Ich habe meinen Obsidian-Tresor an einem Mittwochnachmittag kaputt gemacht, und die Art und Weise, wie er kaputt ging, ist der Grund, warum ich mich auf die Suche nach etwas anderem gemacht habe.

Ich habe Notizen aus zwei Jahren umgestaltet. Ein Ordner namens bug-logs/ war auf 312 Dateien angewachsen, und ich wollte ihn nach Projekt aufteilen – bug-logs/laravel/, bug-logs/react/, Standardreinigung. So etwas macht jeder Entwickler, wenn ein flacher Ordner zu einem Sumpf wird.

Ich habe 47 Dateien in einem Stapel verschoben, zugesehen, wie Obsidian sie umbenannt hat, und bin Kaffee kochen gegangen. Als ich zurückkam, öffnete ich ein Runbook, das ich sechs Monate zuvor geschrieben hatte – ein schrittweises Wiederherstellungsdokument für einen Produktionsvorfall, den ich nie wiederholen wollte. Der dritte Schritt ist mit einem Fehlerprotokoll namens redis-eviction-storm-debug.md verknüpft. Der Link wird als einfacher Text gerendert. Klicken hat nichts bewirkt.

Ich habe die Datei überprüft. Es existierte. Es befand sich im neuen Ordner bug-logs/infra/. Der Block, auf den ich verwiesen hatte – der spezifische Abschnitt, der die Räumungskonfiguration erläutert, die die Kaskade ausgelöst hat – war genau dort, unberührt. Aber der Link war tot, weil sich der Pfad geändert hatte und die Blockreferenz an einer Pfad-plus-Überschrift-Kombination verankert war, die nicht mehr übereinstimmte.

In diesem Moment wurde mir klar, dass mein zweites Gehirn ein strukturelles Problem hatte. Nicht unbedingt die Schuld von Obsidian. Markdown-Dateien plus Dateisystempfade plus in Überschriften verankerte Blocklinks – das ist der Vertrag. Wenn Sie Dinge verschieben, akzeptieren Sie, dass einige Referenzen kaputt gehen. Für ein persönliches Tagebuch ist das in Ordnung. Was die Dokumentation betrifft, auf die ich mich bei einem Vorfall um 2 Uhr morgens verlassen kann, ist das kein Problem.

Also fing ich an, über Obsidian hinauszuschauen. Das, was ich als Nächstes getestet habe, war SiYuan, ein Open-Source-Wissensmanagement-Tool mit lokaler Ausrichtung, das ab dem 21. April 2026 Version 3.6.5 ausführt. Blockverweise werden anders verarbeitet – jeder Block hat eine permanente ID, die Verschiebungen, Umbenennungen, Umgestaltungen und alles andere als das Löschen übersteht. Das hörte sich genau nach dem an, was mein kaputtes Runbook brauchte.

Das ist der ehrliche Bericht. Was hat funktioniert. Was mich dazu brachte, nach dem Zurück-Knopf zu greifen. Ob es einen festen Platz im Entwicklerstapel im Jahr 2026 verdient oder ob der Vergleich SiYuan vs Obsidian für die meisten Menschen immer wieder zu Obsidian tendiert. Spoiler: Die Antwort hängt davon ab, welche Art von Notizen Sie tatsächlich führen.

Warum ich überhaupt an Obsidian vorbeigeschaut habe

Obsidian hat mir vier Jahre lang gedient. Ich bin nicht hier, um es zu begraben. Die über 230 Beiträge auf dieser Website beziehen sich ständig auf Obsidian, da es für den Anwendungsfall, für den es entwickelt wurde – ein schnelles, durch Plugins erweiterbares zweites Gehirn im Klartext – fast nichts übertrifft.

Aber meine Notizen haben sich weiterentwickelt. Sie hörten auf, „laut zu denken“, und verwandelten sich in strukturierte Artefakte:

• Fehlerprotokolle mit reproduzierbaren Schritten, Ursachenanalyse und Fehlerbehebungsüberprüfung
• Architekturentscheidungsdatensätze (ADRs) mit explizitem Kontext, Entscheidung und Konsequenzen – Runbooks für Produktionsvorfälle mit sequenzierten Wiederherstellungsschritten
• Notizen zur Kundeneinbindung mit verknüpften Fehlerprotokollen, Entscheidungen und Runbooks
• Langzeitprojektdokumentation mit mehreren Mitwirkenden (ich + Subagenten, die Speicherdateien schreiben)

Sobald Ihre Notizen eher wie ein Dokumentationssystem als wie ein Tagebuch aussehen, beginnen drei Obsidian-Einschränkungen zu schleifen:

1. Blockverweise werden beim Refactoring unterbrochen. Die Blockverweissyntax von Obsidian ([[file#^block-id]]) verankert sich auf eine bestimmte Block-ID in einer bestimmten Datei. Wenn Sie die Datei verschieben, versucht Obsidian, den Pfad automatisch zu aktualisieren. Meistens funktioniert es. Manchmal ist dies nicht der Fall, insbesondere bei Batch-Verschiebungen, der durch Plugins eingeführten Syntax oder der externen Editor-Synchronisierung. Und wenn es stillschweigend fehlschlägt, bemerken Sie es erst, wenn Sie sechs Monate später auf einen Link klicken.

2. Datenbankabfragen erfordern Plugins. Die Datenansicht ist brillant. Es handelt sich außerdem um ein Community-Plugin, das von einem Entwickler gepflegt wird und etwa zweimal im Jahr die wichtigsten Obsidian-Releases durchbricht. Wenn Ihr Runbook davon abhängt, dass eine Dataview-Abfrage korrekt gerendert wird, hängt Ihr Runbook davon ab, dass Dataview fehlerfrei ist. Das ist eine fragile Abhängigkeitskette für produktionskritische Dokumente.

3. Die Mehrbenutzerbearbeitung ist nicht das Modell. Obsidian Sync ist vorhanden und eignet sich gut für den persönlichen Gebrauch. Aber Obsidian wurde als Einzelbenutzer-Tool konzipiert. Sobald Sie möchten, dass ein Team oder Subagenten gleichzeitig in denselben Tresor schreiben, kämpfen Sie gegen das Modell.

Der Vorfall mit dem geknackten Link war nur die Oberfläche. Darunter verbarg sich eine tiefere Erkenntnis: Meine Notizen waren über das Markdown-Datei-als-Dokument-Modell hinausgewachsen. Ich brauchte ein System, bei dem die atomare Einheit der Block und nicht die Datei war. Wo Referenzen Strukturänderungen überlebten. Wo Abfragen nativ und nicht angereichert waren.

Das ist die Nische, um die SiYuan vs Obsidian tatsächlich kämpft.

Was Block IDs tatsächlich tut – ein echtes Beispiel

Der Clou: Jeder Block in SiYuan erhält in dem Moment, in dem Sie ihn erstellen, eine permanente 22-stellige ID. Die ID bleibt für immer im Block – bei Verschiebungen, Umbenennungen, Dokumentteilungen und Dokumentzusammenführungen. Referenzen verweisen auf die ID, nicht auf den Pfad. Verschiebe den Block. Die Referenz funktioniert immer noch.

Klingt in der Theorie gut. So sieht es in der Praxis tatsächlich aus.

Ich habe ein Dokument namens redis-eviction-storm.md erstellt und drei Blöcke geschrieben:

- Symptom: Redis CPU spikes to 100% for 90 seconds, then recovers.
- Root cause: maxmemory-policy set to allkeys-lru with eviction batch
  size of 10. Under high write load, eviction cycle blocks the event loop.
- Fix: Switch to allkeys-lfu, raise hz to 50, set maxmemory-eviction-tenacity to 5.

SiYuan hat jedes Aufzählungszeichen als separaten Block gespeichert. Als ich auf das zweite Aufzählungszeichen klickte, zeigte mir der Editor seine Block-ID – etwa 20260418142733-x7k9j2m. Das ist ein 14-stelliger Zeitstempel (20260418142733 = 18. April 2026, 14:27:33) plus 7 zufällige Zeichen. Jeder Block in Ihrem Arbeitsbereich erhält einen.

Ich habe die Blockreferenz kopiert und in ein anderes Dokument eingefügt – ein Runbook namens incident-recovery-redis.md. Die Referenz wird als anklickbare Einbettung gerendert und zeigt den Text zur Ursache inline an. Dann habe ich das Zerstörerische getan, das Obsidian kaputt gemacht hat: Ich habe das Quelldokument in einen tief verschachtelten Ordner verschoben, es in infra/databases/redis/eviction-storm-2026.md umbenannt und es in zwei separate Dokumente aufgeteilt.

Die Referenz in meinem Runbook funktionierte immer noch. „Hat nach der Neuindizierung nicht funktioniert“. Funktionierte nicht, nachdem das Plugin die Pfade abgeglichen hatte. Funktionierte sofort, da die Referenz an die Block-ID und nicht an den Dateipfad gebunden war. Der zugrunde liegende Speicher ist eine .sy JSON-Datei, die einen AST-Knotenbaum enthält, und die Block-ID ist die AST-Knoten-ID. Verschieben Sie das Dokument, die Datei wird verschoben; Die JSON-Knoten-IDs bleiben unverändert. SQLite indiziert den Dateipfad neu, die Referenzauflösungsschicht sucht den Block anhand der ID, findet ihn in der neuen Datei und rendert ihn.

Dies ist für mich das einzige Merkmal, das die Existenz von SiYuan rechtfertigt. Wenn Sie jemals einen Blockverweis auf einen Refactor verloren haben, wissen Sie genau, wie wichtig das ist.

Der Kompromiss liegt auf der Ebene des Dateiformats, und wir werden darauf zurückkommen – denn .sy JSON ist nicht Markdown, und das hat Konsequenzen.

Das Killer-Feature: Native SQL-Abfragen in Notizen

Obsidian-Benutzer greifen nach Dataview. Notion-Benutzer erstellen relationale Datenbanken manuell. SiYuan wird mit einer SQLite-Datenbank geliefert, die jeden Block in Ihrem Arbeitsbereich indiziert, und Sie schreiben SQL direkt in Notizen.

Kein Plugin. Kein Sidebar-Tool. Die Abfrage befindet sich inline als Einbettungsblock, wird beim Rendern des Dokuments ausgeführt und aktualisiert, wenn sich die zugrunde liegenden Daten ändern.

Hier ist eine echte Abfrage, die ich oben in meinem bug-tracker.md-Dokument behalte. Es ruft jeden mit #bug-open gekennzeichneten Block in meinem gesamten Arbeitsbereich ab, sortiert nach Erstellungsdatum:

SELECT
  '[' || b.content || '](siyuan://blocks/' || b.id || ')' AS bug,
  b.hpath AS document,
  datetime(substr(b.created, 1, 4) || '-' ||
           substr(b.created, 5, 2) || '-' ||
           substr(b.created, 7, 2)) AS opened
FROM blocks AS b
WHERE b.tag LIKE '%#bug-open%'
ORDER BY b.created DESC
LIMIT 50

Dies macht drei Dinge richtig, die Dataview nie für mich getan hat:

Es ist echtes SQL. Kein DSL, das SQL mit seinen eigenen Macken umhüllt. Wenn Sie in Ihrer Karriere einen SELECT geschrieben haben, können Sie am ersten Tag SiYuan-Abfragen schreiben. Nimmt an der Arbeit teil. Unterabfragen funktionieren. CTEs funktionieren. Das Schema ist dokumentiert und stabil – blocks ist die Haupttabelle mit Spalten wie id, content, type, path, hpath, updated, markdown und einige mehr.

Das Schema ist offengelegt. In der API-Dokumentation von SiYuan wird das Tabellenschema blocks explizit aufgeführt. Es gibt auch einen /api/query/sql-HTTP-Endpunkt, der einen JSON-Körper wie {"stmt": "SELECT * FROM blocks WHERE content LIKE '%redis%' LIMIT 7"} annimmt und Zeilen zurückgibt. Das bedeutet, dass externe Skripte, Agenten oder sogar Claude Code selbst Ihre Wissensdatenbank direkt abfragen können, ohne Markdown-Dateien zu analysieren.

Einbettungsblöcke sind erstklassig. Jeder Einbettungsblock in SiYuan beginnt mit select * from blocks – das ist die Konvention, da der Einbettungsrenderer das Blockschema benötigt, um zu wissen, wie Ergebnisse gerendert werden. Die Abfrage wird beim Laden des Dokuments, bei Datenänderungen und bei manueller Aktualisierung aktualisiert.

Ich habe jetzt in meinem Arbeitsbereich Abfragen eingebettet:

– Ein Dashboard oben in meinem Projektdokument, das jeden TODO-Block im Unterbaum des Projekts auflistet

• Eine Abfrage nach „veralteten Notizen“, die alle Dokumente anzeigt, die ich seit mehr als 90 Tagen nicht aktualisiert habe – Eine Fehlerabfrage nach Schweregrad, die offene Fehler nach den Tags #sev1, #sev2, #sev3 gruppiert – Eine „Heute“-Abfrage in meiner täglichen Notiz, die jeden Block abruft, den ich an diesem Tag erstellt oder geändert habe

Dataview kann das meiste davon erledigen. Der Unterschied besteht darin, dass die Abfrageschicht von SiYuan Teil des Kernprodukts ist und kein Community-Plugin, das von einem heldenhaften Entwickler verwaltet wird. Das Schema ist stabil. Die Abfrage-Engine ist SQLite, die langweiligste und zuverlässigste Datenbanksoftware, die es gibt. Ich vertraue ihm bei produktionskritischen Dokumenten auf eine Art und Weise, wie ich Dataview nie ganz vertraut habe.

Docker Self-Host Walkthrough – Das 2026-Setup

SiYuan läuft als Desktop-App auf macOS, Windows und Linux. Es läuft auch als Docker-Container, und so hoste ich meinen Hauptarbeitsbereich – auf einem kleinen VPS, auf den ich von jedem Gerät aus zugreifen kann und der vollständig unter meiner Kontrolle steht.

Das offizielle Docker-Image ist b3log/siyuan auf dem Docker-Hub. Der Standardport ist 6806. Der minimale Befehl, um einen Arbeitsbereich zum Laufen zu bringen:

docker run -d \
  --name siyuan \
  -p 6806:6806 \
  -v /opt/siyuan/workspace:/siyuan/workspace \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Asia/Dhaka \
  b3log/siyuan \
  --workspace=/siyuan/workspace/ \
  --accessAuthCode=replace-with-a-strong-password

Drei Dinge in diesem Befehl sind wichtig und aus den Dokumenten nicht ersichtlich:

Das --workspace-Flag muss mit dem Container-seitigen Mount-Pfad übereinstimmen. SiYuan speichert alles im Arbeitsbereichsordner – Ihre Notizbücher, den SQLite-Index, Anhänge, Plugin-Daten, Synchronisierungsmetadaten. Wenn das Flag und die Volume-Bereitstellung nicht übereinstimmen, startet der Container, schreibt aber nichts Nützliches auf die Festplatte, und beim Neustart verlieren Sie den Status.

--accessAuthCode ist Ihr Passwort. Es ist das einzige, was zwischen Port 6806 und jedem steht, der Ihren VPS erreichen kann. Verwenden Sie eine lange Zufallszeichenfolge. Behandeln Sie es wie einen SSH-Schlüssel. Wenn Sie es vergessen, müssen Sie den Container stoppen, die Konfiguration im Arbeitsbereichsordner bearbeiten und neu starten.

PUID/PGID entspricht Ihrem Host-Benutzer. Ohne diese schreibt der Container Dateien als Root, und wenn Sie sich per SSH anmelden, um den Arbeitsbereich zu sichern, können Sie Ihre eigenen Daten ohne sudo nicht lesen. Führen Sie id -u und id -g auf Ihrem Host aus und übergeben Sie diese Werte.

Docker Compose-Version, die ich tatsächlich ausführe:

version: "3.9"
services:
  siyuan:
    image: b3log/siyuan
    container_name: siyuan
    restart: unless-stopped
    ports:
      - "127.0.0.1:6806:6806"
    volumes:
      - /opt/siyuan/workspace:/siyuan/workspace
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Asia/Dhaka
    command:
      - --workspace=/siyuan/workspace/
      - --accessAuthCode=${SIYUAN_AUTH_CODE}

Beachten Sie die Bindung an 127.0.0.1:6806 – ich stelle Port 6806 niemals direkt dem öffentlichen Internet zur Verfügung. NGINX liegt mit TLS, Basisauthentifizierung als zweiter Schicht und einer strengen Zulassungsliste für IPs, die den Upstream erreichen können, an der Spitze. Das ist die gleiche Haltung, die ich bei jedem selbst gehosteten Produktivitätstool einnehmen würde, und so etwas würde meine Sicherheitsüberprüfungs-Checkliste für selbst gehostete Apps markieren, wenn ich sie überspringen würde.

NGINX-Serverblock, abgekürzt:

server {
  listen 443 ssl http2;
  server_name notes.example.com;

  ssl_certificate     /etc/letsencrypt/live/notes.example.com/fullchain.pem;
  ssl_certificate_key /etc/letsencrypt/live/notes.example.com/privkey.pem;

  location / {
    proxy_pass http://127.0.0.1:6806;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
    proxy_set_header Host $host;
    proxy_read_timeout 3600s;
    proxy_send_timeout 3600s;
  }
}

Die Upgrade-Header im WebSocket-Stil sind wichtig – SiYuan verwendet eine dauerhafte Verbindung zwischen dem Browser-Client und dem Backend. Ohne sie erhalten Sie alle ein oder zwei Minuten zufällige Toasts mit dem Hinweis „Verbindung unterbrochen“.

Nachdem der Container hochgefahren ist, drücken Sie https://notes.example.com, geben Ihren Zugangscode ein und schon sind Sie dabei. Der Browser-Client bietet das vollständige SiYuan-Erlebnis – dieselbe Benutzeroberfläche wie die Desktop-App, dieselbe Plugin-Unterstützung, dieselbe Abfrage-Engine. Das Einzige, was fehlt, sind die Integrationen auf Betriebssystemebene wie die Taskleiste.

Das ist eine 10-minütige Einrichtung, wenn Sie bereits einen VPS haben. Vergleichen Sie mit Obsidian, wo die selbstgehostete Synchronisierung mehrerer Geräte Dienste von Drittanbietern, S3-Buckets oder das kostenpflichtige Obsidian-Synchronisierungsabonnement umfasst. Die native Selbsthostbarkeit von SiYuan ist ein struktureller Vorteil und kein nettes Extra.

Diagrammansicht – Nützliches Tool oder Augenweide?

Die Diagrammansicht von Obsidian wurde nicht ohne Grund zu einem Meme. Es ist wunderschön. Für die meisten Menschen ist es auch ein Bildschirmschoner. Sie starren auf die Konstellation Ihrer Notizen, fühlen sich kurz von der scheinbaren Tiefe Ihrer Gedanken beeindruckt und schließen dann die Registerkarte.

SiYuan bietet eine eigene Diagrammansicht, und ich möchte Ihnen sagen, dass sie anders ist. Meistens ist es das nicht.

Gleiche Knoten- und Kantenvisualisierung. Dieselbe Physiksimulation, mit der Sie Cluster verschieben können. Gleiche Farbcodierung nach Tag oder Dokumenttyp. Die Interaktivität ist in Ordnung. Sie können auf einen Knoten klicken und zum Dokument springen. Sie können nach Tag, Tiefe, Dokumenttyp oder Zeitraum filtern.

Was SiYuan hinzufügt, sind Diagrammknoten auf Blockebene. Das Diagramm von Obsidian behandelt Dateien als Knoten. SiYuan kann einzelne Blöcke als Knoten darstellen, was bedeutet, dass das Diagramm die tatsächliche Referenzstruktur widerspiegelt – ein Block in Dokument A, auf den von einem Block in Dokument B verwiesen wird, wird als Kante zwischen Blöcken und nicht zwischen Dateien angezeigt.

Ist das wirklich nützlich? Zweimal in drei Monaten, ja. Einmal suchte ich nach verwaisten Blöcken (Blöcke, die ich zwar geschrieben, aber nirgendwo referenziert hatte) und einmal, als ich nachverfolgte, wie sich eine bestimmte Architekturentscheidung über mehrere ADRs hinweg ausgebreitet hatte. Beide Male zeigte mir das Diagramm auf Blockebene etwas, was ein Diagramm auf Dateiebene verborgen gehalten hätte.

In den anderen 90 % der Fälle bleibt die Diagrammansicht geschlossen. Ich glaube nicht, dass dies ein SiYuan-spezifischer Fehler ist. Ich denke, dass Diagrammansichten als Wissenstool im Allgemeinen überbewertet werden. Sie eignen sich für gelegentliche Strukturinspektionen und nicht für die tägliche Arbeit.

Wenn Sie sich allein aufgrund der Qualität der Diagrammansicht zwischen SiYuan und Obsidian entscheiden, sollten Sie dies nicht tun. Sie sind gleichwertig. Die Option auf Blockebene in SiYuan ist für eine kleine Anzahl von Anwendungsfällen ein geringfügiger Gewinn.

Dateiformat-Realitätsprüfung – .sy JSON, nicht Markdown

Hier verlangt SiYuan das größte Engagement und die meisten Bewertungen lassen die Kosten außer Acht.

Obsidian speichert Notizen als .md-Dateien. Einfach Markdown. Sie können sie in Vim, in VS Code, im Notepad und in jedem Editor öffnen, der in den letzten 30 Jahren existiert hat. Wenn Obsidian morgen verschwindet, sind Ihre Notizen immer noch lesbar.

SiYuan speichert Markdown nicht. Es speichert .sy-Dateien, bei denen es sich um JSON-Dokumente handelt, die den abstrakten Syntaxbaum (AST) jeder Notiz enthalten. Dateinamen bestehen aus 14-stelligen Zeitstempeln plus 7 zufälligen Zeichen – etwa 20260418142733-x7k9j2m.sy. Die Verzeichnisstruktur spiegelt Ihre Notebook-Hierarchie wider. Der Inhalt befindet sich im JSON und wird zur Laufzeit von SQLite indiziert.

Dies ist der Kompromiss, den Sie für stabile Block-IDs zahlen. Die Block-ID ist die AST-Knoten-ID. Der AST muss in einem strukturierten Format beibehalten werden, um die IDs über Bearbeitungen hinweg stabil zu halten. Markdown trägt konstruktionsbedingt keine Identität auf Blockebene – es gibt keine spezifikationskonforme Möglichkeit, eine ID in einem Absatz in CommonMark zu verankern. Wenn Sie die Block-ID-Garantien wünschen, können Sie nicht einfach Markdown als Speicherformat verwenden. Wählen Sie eine aus.

Was das eigentlich für die Portabilität bedeutet:

Sie können nach Markdown exportieren. SiYuan verfügt über einen integrierten Markdown-Export – einzelnes Dokument, Ordner oder gesamter Arbeitsbereich. Der Export ist gut. Blockverweise werden zu Standardverweisen im Wiki-Link-Stil, Codeblöcke bleiben erhalten, Tabellen werden sauber konvertiert. Du wirst nicht eingesperrt.

Sie können den Speicher nicht direkt bearbeiten. Wenn Sie Ihre Notizen mit einem sed-Skript massenhaft ändern möchten, wie Sie es vielleicht mit einem Obsidian-Tresor tun würden, werden Sie JSON AST-Knoten analysieren, nicht die Regex-Matching-Markdown. Das ist machbar – das AST-Schema ist dokumentiert – aber es ist eine Größenordnung mehr Arbeit als ein Einzeiler gegen .md-Dateien.

Die Integration externer Tools ist schwieriger. Tools wie Pandoc, Marksman, Markdownlint oder eines der Dutzenden CLI-Dienstprogramme, die mit Markdown-Dateien arbeiten, funktionieren nicht direkt mit .sy JSON. Sie können exportieren, das Tool ausführen und erneut importieren – aber das ist ein Workflow und kein Reflex.

Synchronisierungskonflikte sehen anders aus. Wenn Sie einen Arbeitsbereich über Syncthing oder rsync zwischen zwei Computern synchronisieren, sind Konflikte in .sy JSON-Dateien schwieriger manuell zu lösen als Konflikte im einfachen Markdown. Die offizielle Synchronisierung von SiYuan (eine kostenpflichtige Mitgliedschaftsfunktion) erledigt dies mit einer Ende-zu-Ende-verschlüsselten inkrementellen Synchronisierung, aber wenn Sie Ihre eigene Synchronisierung durchführen, werden Sie dies spüren.

Für mich lohnt sich der Kompromiss. Meine Notizen sind jetzt Infrastruktur, keine Literatur. Ich möchte, dass sie abfragbar, referenzstabil und strukturell explizit sind. Der JSON-AST-Speicher ist der Preis für diese Eigenschaften, und der Markdown-Export bietet mir einen Notausgang, falls ich es mir jemals anders überlege. Wenn Ihre Notizen jedoch hauptsächlich aus Prosa bestehen – Tagebücher, Belletristik, tägliche Reflexionen – und der Reiz von .md in der Bearbeitbarkeit mit jedem Tool liegt, ist SiYuan die falsche Wahl und Sie sollten bei Obsidian bleiben. Das ist kein Fehler. Es ist eine Designsteuer für ein anderes Ziel.

SiYuan vs. Obsidian vs. Notion – Ehrlicher Vergleich

Jeder „X vs. Y“-Artikel geht schließlich in eine Feature-Matrix über. Hier ist meine, mit dem Haken, dass die Zeilen, die am wichtigsten sind, die Zeilen sind, in denen die drei Tools wirklich anderer Meinung sind.

Einkaufszentrum, überwiegend chinesisch | Groß, Englisch zuerst | Keine – geschlossene Plattform | | Zusammenarbeit in Echtzeit | Begrenzt | Begrenzt | Ausgezeichnet | | Offline-zuerst | Voll | Voll | Teilweise (nur Cache) | | Lernkurve | Anfangs steil | Mäßig | Flach | | Mobile Apps | iOS, Android, HarmonyOS | iOS, Android | iOS, Android | | Kosten | Kostenlos (kostenpflichtige Synchronisierung optional) | Kostenlos (kostenpflichtige Synchronisierung optional) | Kostenlose → kostenpflichtige Stufen |

Meine Meinung, Zeile für Zeile, zu den Zeilen, die wirklich wichtig sind:

Referenzstabilität. SiYuan gewinnt auf Anhieb. Das ist die Funktion, die mich fasziniert hat und die ich immer wieder zu schätzen weiß. Wenn Sie Notizen regelmäßig umgestalten, ist dies wichtiger als alles andere.

Native Abfrage. SiYuan gewinnt erneut mit Abstand. SQL > Dataview DSL > Filter-Benutzeroberfläche von Notion. Die Tatsache, dass die Abfrage-Engine Teil des Kernprodukts und kein Plugin ist, macht bei produktionskritischen Dokumenten einen echten Unterschied.

Dateiformat-Portabilität. Obsidian gewinnt, Punkt. Plain Markdown ist das tragbarste Notizformat, das jemals erfunden wurde. Sie geben dies auf, um die Block-IDs zu erhalten.

Plugin-Ökosystem. Obsidian gewinnt mit Abstand. Der Marktplatz von SiYuan existiert, das Community-Basar-Repository wird stündlich automatisch aktualisiert und es gibt eine aktive Entwicklung – aber das Ökosystem ist kleiner und tendiert zu Plugins in chinesischer Sprache. Die Auswahl an englischsprachigen Plugins ist spärlich und die englische Dokumentation für die Plugin-Entwicklung wird offen als Bereich mit Arbeitsbedarf anerkannt. Wenn Sie mit Community-Plugins leben und sterben, ist das wichtig.

Zusammenarbeit in Echtzeit. Notion gewinnt. Nichts im Local-First-Bereich kommt dem Notion-Erlebnis „zehn Personen, die gleichzeitig dieselbe Seite bearbeiten“ nahe. Wenn Ihre Notizen ein Teamartefakt sind, ist Notion die Antwort und SiYuan vs. Obsidian ist der völlig falsche Rahmen.

Selbsthosting und Eigentum. SiYuan gewinnt. Obsidian ist zuerst lokal, aber die offizielle Synchronisierung ist eine kostenpflichtige SaaS. Notion ist reine Cloud. SiYuan mit Docker bietet Ihnen die Local-First-Vorteile und den Multi-Device-Komfort, ohne darauf angewiesen zu sein, dass die Server anderer Personen online bleiben.

Der Vergleich der Überschrift „SiYuan vs Obsidian“ lautet: SiYuan, wenn es sich bei Ihren Notizen um strukturierte Dokumentation handelt; Obsidian, wenn es sich bei Ihren Notizen um Prosa plus Plugins handelt. Der Notion vs SiYuan-Vergleich ist noch einfacher: Notion, wenn Sie Teamzusammenarbeit in Echtzeit benötigen; SiYuan, wenn Sie Privatsphäre, Eigentum und eine von Ihnen kontrollierte Abfragemaschine benötigen.

Wo SiYuan verliert

Bisher war ich großzügig. Hier sind die Ecken und Kanten, auf die ich gestoßen bin, in der Reihenfolge ihrer Priorität.

Das Plugin-Ökosystem ist klein und auf Englisch schwer zu navigieren. Die Entwicklergemeinschaft von SiYuan spricht größtenteils Chinesisch, was für die Tiefe und Konsistenz des Projekts gut ist, für Benutzer, die nur Englisch sprechen, weniger gut. Die Benutzeroberfläche des Marktplatzes ist zweisprachig, aber die Plugin-Beschreibungen und die Dokumentation basieren oft auf Chinesisch. Es gibt ein offenes GitHub-Problem (#12878), bei dem es ausdrücklich um die Verbesserung der englischen Unterstützung geht. Wenn Ihre Vorstellung von einem perfekten Notiz-Tool handverlesene Community-Plugins für jeden Mikro-Workflow umfasst, wird Sie SiYuan frustrieren.

Die Benutzeroberfläche wirkt auf einige Benutzer veraltet. Das ist subjektiv und ich versuche fair zu sein. Die Designsprache von SiYuan ähnelt eher einer funktionsreichen IDE aus dem Jahr 2018 als einer minimalistischen App aus dem Jahr 2026. Es gibt viele Knöpfe. Der Symbolsatz ist beschäftigt. Das Standardthema ist in Ordnung, aber nicht schön. Wenn Sie sich für die klare schlichte CSS-Ästhetik von Obsidian oder das luftige Design von Notion entscheiden, wird Ihnen die erste Stunde in Nach einer Woche merkt man es nicht mehr – aber der erste Eindruck zählt.

Leistungseinbußen bei großen Arbeitsbereichen. Das mit SQLite indizierte Modell ist schnell, bis es nicht mehr schnell ist. Mein Hauptarbeitsbereich umfasst etwa 1.800 Dokumente mit insgesamt vielleicht 40.000 Blöcken, und SiYuan bewältigt ihn ohne Beanstandung. Personen, die berichtet haben, dass sie mehr als 10.000 Dokumentarbeitsbereiche ausgeführt haben, beschreiben eine spürbare Verzögerung bei der Volltextsuche und der Darstellung von Diagrammen. Es gibt einen aktiven Engineering-Thread zur Optimierung, aber wenn Ihr vorhandener Obsidian-Tresor wirklich umfangreich ist, überprüfen Sie die Leistung, bevor Sie ihn festlegen.

Die Kosten für die Migration von Notion sind real. Der Export von Notion ist HTML oder Sie können die meisten Inhalte abrufen, verlieren jedoch Notion-spezifische Dinge: relationale Datenbanklinks, Seiteneigenschaften, Einbettungen und alle nur für Notion gültigen Blocktypen. Planen Sie ein Wochenende, keinen Nachmittag.

Das mobile Erlebnis ist funktional, nicht erfreulich. Die Android- und iOS-Apps funktionieren. Sie synchronisieren. Sie rendern korrekt. Aber der Editor auf Mobilgeräten ist im Vergleich zum Desktop eindeutig ein Bürger zweiter Klasse. Die Blockmanipulation auf einem Telefon ist umständlich und komplexe Blöcke (SQL-Einbettungen, Diagramme, Mathematik) werden oft zwar gerendert, aber nicht gut bearbeitet. Wenn Sie Notizen zuerst auf Mobilgeräten erfassen müssen, stellt dies eine echte Einschränkung dar.

Mitgliedschaftsstufenfunktionen für erweiterte Synchronisierung. Die Ende-zu-Ende-verschlüsselte Synchronisierung ist eine kostenpflichtige SiYuan-Mitgliedschaftsfunktion. Die kostenlose Stufe ist voll funktionsfähig – Sie können mit Docker selbst hosten, über Syncthing oder ein anderes Tool synchronisieren und nichts verlieren. Das ausgefeilteste Synchronisierungserlebnis findet jedoch hinter einer Paywall statt. Das ist fair und die Entwickler verdienen es, bezahlt zu werden, aber es lohnt sich, es zu wissen, bevor Sie davon ausgehen, dass das kostenlose Erlebnis mit den Marketing-Screenshots übereinstimmt.

Nichts davon ist für mich ein Deal-Breaker. Zusammen sind sie der Grund dafür, dass SiYuan vs Obsidian keinen universellen Gewinner hat.

Wer sollte wechseln, wer nicht

Vergessen Sie allgemeine Ratschläge. Hier finden Sie konkrete Profile.

Wechseln Sie zu SiYuan, wenn Sie:

• Ein Entwickler, der ein persönliches Dokumentationssystem verwaltet – Fehlerprotokolle, Runbooks, ADRs, Post-Mortem-Analysen von Vorfällen –, bei dem die Referenzstabilität über Refactors hinweg wichtiger ist als die Flexibilität des Editors – Jeder, der einen Blockverweis bei einer Obsidian-Umbenennung verloren hat und möchte, dass das nicht mehr passiert – Ein Selbsthoster, der strukturierte Dokumente im Notion-Stil möchte, sich aber weigert, proprietäre Daten auf den Servern anderer zu platzieren
• Jemand, der eine Wissensdatenbank erstellt, die von AI-Agenten abgefragt wird – der SQLite-Index plus HTTP API plus stabile Block-IDs machen die Agentenintegration wirklich nachvollziehbar – Ein starker Benutzer des relationalen Denkens, der derzeit gegen Dataview kämpft und sich wünscht, dass die Abfrageebene eine echte Datenbank wäre

Bleiben Sie bei Obsidian, wenn Sie:

• Ein Tageszeitschriftschreiber oder Essayist, dessen Notizen größtenteils aus Prosa bestehen
• Stark in das Obsidian-Plugin-Ökosystem investiert (Excalidraw, Obsidian Tasks, Smart Connections, Templater) – keines davon hat direkte SiYuan-Äquivalente
• Jemand, der .md-Portabilität über Tools hinweg benötigt (Pandoc, statische Site-Generatoren, externe Editoren)
• Ein Einzelbenutzer, bei dem sich das Problem mit gebrochenen Links nicht lohnt, das Tool zu wechseln

Bleiben Sie bei Notion, wenn Sie:

• Arbeiten an freigegebenen Dokumenten mit einem Team, das Echtzeit-Multiplayer-Bearbeitung benötigt
• Ein technisch nicht versierter Benutzer, der die Designsprache und das Vorlagen-Ökosystem von Notion schätzt
• Erstellen eines Wikis für ein Unternehmen, dessen Eigentümer „das Unternehmen“ und nicht „ich persönlich“ ist.

Führen Sie beide aus, wenn Sie:

– Ein Entwickler mit einem starken vorhandenen Obsidian-Tresor, aber einem wachsenden Problem mit strukturierten Dokumenten. Das ist es, was ich tue. Obsidian für schnelle Erfassung und Prosa; SiYuan für die strukturierte Dokumentationsschicht; Die beiden interagieren über den Markdown-Export, wenn ich Dinge zwischen ihnen verschieben muss.

Der Fehler, den es zu vermeiden gilt, besteht darin, dies als Entweder-Oder zu betrachten. Die Kosten für den Betrieb zweier Tools sind real, aber gering. Die Kosten für das Erzwingen prosaischer Notizen in SiYuan oder strukturierter Dokumente in Obsidian sind viel höher.

Mein aktuelles Setup – Was ich behalten habe, was ich migriert habe

Drei Monate nach der ersten Installation von SiYuan sehen Sie hier die tatsächliche Arbeitsteilung auf meinem System.

Aufenthalt in Obsidian: tägliche Notizen, Tagebucheinträge, flüchtige Aufzeichnungen, alles, was ich schreibe, um nachzudenken und nicht um es zu dokumentieren. Etwa 1.200 Dateien. Das Plugin-Ökosystem (insbesondere Templater, Dataview-for-prose und das Local Images Plus-Plugin aus meinem RAG-Setup im Karpathy-Stil) ist zu wertvoll, um es aufzugeben. Ich baue mein zweites Gehirn immer noch auf Obsidian auf, was ich in meinem ausführlichen Einblick in Obsidian und Claude Code für die Prosa- und Denkebene behandelt habe.

Migriert nach SiYuan: Fehlerprotokolle (312 Dateien), Runbooks (84 Dateien), ADRs (47 Dateien), Dokumente zur Kundeneinbindung (ca. 200 Dateien) und Projektdokumentation für aktive Einsätze (variabel). Ungefähr 700 Dokumente, Tendenz steigend. Alles, wo Referenzstabilität und SQL-Abfragbarkeit wichtiger sind als Markdown-Portabilität.

Die Integrationsschicht: ein kleines Node.js-Skript, das jede Nacht ausgeführt wird, den SiYuan-Arbeitsbereich über API nach Markdown exportiert und den Export in einem Ordner mit Obsidian-Indizes ablegt. Schreibgeschützt, aber das bedeutet, dass meine Obsidian-basierte Suche Inhalte von der SiYuan-Seite finden kann. Die umgekehrte Richtung (Obsidian → Die Abhängigkeit geht in eine Richtung.

Die Agentenschicht: Claude Code fragt meine SiYuan SQLite-Datenbank direkt ab, wenn ich mit Wissensgraphen arbeite. Ich habe das allgemeine Muster von RAG im Karpathy-Stil über Markdown-Tresoren behandelt – SiYuan ist ein reichhaltigeres Substrat für dieselbe Idee, da das Schema strukturiert ist. Anstatt Markdown zu greifen, führt der Agent SQL aus: „Geben Sie mir jeden Fehlerblock mit dem Tag sev1 aus den letzten 30 Tagen, in dem die Grundursache Redis erwähnt.“ Diese Abfrage dauert 40 ms und gibt exakte Blöcke zurück, keine Blöcke. Für Entwickler-Second-Brain-Workflows, bei denen der Agent strukturierten Kontext benötigt, ist dies ein sinnvolles Upgrade.

Wofür ich SiYuan NICHT verwende: Schreiben dieses Blogbeitrags. Der Beitrag, den Sie gerade lesen, wurde in Obsidian entworfen, in VS Code bearbeitet und als Markdown gespeichert. Bei Inhalten, die im öffentlichen Web landen, setzt sich nach wie vor das Klartext-Überall-Modell durch. SiYuan ist für Dokumente gedacht, die privat bleiben und von der Struktur profitieren.

Das ist das ganze Bild. Zwei Tools, ein Workflow, klare Linien darüber, was wo lebt.

Das Urteil

SiYuan ist nicht der neue Obsidian. SiYuan ist nicht der neue Notion. Wer es so formuliert, übersieht das eigentlich Interessante an dem Tool.

SiYuan ist das, was passiert, wenn man „Block-Level-Identität“ als Grundelement ernst nimmt und ein Wissenssystem darum herum aufbaut. Die Block-ID überlebt Bewegungen. Die SQL-Engine indiziert die Blöcke. Die Diagrammansicht rendert sie. Der HTTP API macht sie verfügbar. Jede Funktion basiert auf derselben architektonischen Verpflichtung: Blöcke sind real, Dateien sind abgeleitet, Pfade sind veränderbar.

Dieses Engagement macht SiYuan für eine strukturierte Dokumentation geeignet. Dies macht auch das Dateiformat undurchsichtig, die Migrationskosten real und das Ökosystem enger als bei Obsidian. Technische Kompromisse sind wie folgt: Wählen Sie die Immobilie aus, die Ihnen am meisten am Herzen liegt, und akzeptieren Sie die damit verbundenen Kosten.

Für den Entwickler, der während eines Refactors eine Blockreferenz zu viel geknackt hat und möchte, dass das Problem nicht mehr besteht, ist SiYuan das Wochenende wert, das für die Einrichtung benötigt wird. Für alle anderen ist die Antwort differenzierter, und ich habe oben versucht, die Grenzen ehrlich zu ziehen.

Erinnern Sie sich an das Runbook, in dem ich gleich zu Beginn den Link verloren habe? Ich habe es an einem Wochenende im Februar in SiYuan umgebaut. Sechs Wochen später überarbeitete ich meine gesamte bug-logs/-Struktur zum zweiten Mal – teilte sie nach Kunden, dann nach Diensten auf und archivierte dann zwei Jahre gelöster Vorfälle. Hunderte Dateien wurden verschoben. Tausende Blöcke wurden neu organisiert.

Ich habe heute Morgen auf den Link im Runbook geklickt. Es hat funktioniert. Sechs Wochen Strukturveränderungen, Dutzende Umzüge und der Hinweis zeigte immer noch genau, wo er hingehörte.

Das ist der gesamte Pitch in einem Satz: In SiYuan funktioniert der Link immer noch. Ob es sich für diese einzelne Eigenschaft lohnt, die Werkzeuge zu wechseln, hängt davon ab, wie oft Sie beobachtet haben, dass sie bei den Werkzeugen, die Sie jetzt verwenden, versagt hat.

Häufig gestellte Fragen

Ist SiYuan wirklich Open Source?

Ja. SiYuan ist unter AGPLv3 lizenziert und die Quelle befindet sich auf GitHub unter siyuan-note/siyuan. Sie können ohne Einschränkung selbst hosten, forken oder Beiträge leisten. Die kostenpflichtige Stufe (Mitgliedschaft) umfasst den offiziellen Cloud-Synchronisierungsdienst, End-to-End-Verschlüsselungsschlüssel und AI-unterstützte Funktionen – aber keine davon ist für die Nutzung des Kernprodukts erforderlich.

Kann ich meinen Obsidian-Tresor auf SiYuan migrieren?

Ja, aber mit Vorbehalten. SiYuan kann Markdown-Dateien und Ordnerstrukturen importieren, was den Großteil eines Obsidian-Tresors abdeckt. Was Sie verlieren: Plugin-spezifische Syntax (Datenansichtsabfragen, Tasks-Plugin-Metadaten, Templater-Vorlagen), Obsidian-spezifische Blockreferenzsyntax und alle benutzerdefinierten CSS. Planen Sie den strukturellen Import und erstellen Sie dann manuell alle Plugin-gesteuerten Workflows in SiYuan-nativen Grundelementen neu.

Ist das Dateiformat .sy ein Risiko einer Anbieterbindung?

Es ist eine echte Überlegung, aber keine feste Bindung. SiYuan bietet einen integrierten Markdown-Export auf Dokument-, Ordner- und Gesamtarbeitsbereichsebene. Der Export erfolgt in High-Fidelity-Qualität für Standardinhalte. Beim Export gehen .sy-spezifische Funktionen (Block-IDs, eingebettete SQL-Abfragen, benutzerdefinierte Blockattribute) verloren, der Text, der Code und die Struktur bleiben jedoch erhalten. Das Risikoprofil liegt eher bei Notion (Export verfügbar, verlustbehaftet) als bei einem echten proprietären Lock-in.

Wie schneidet SiYuan im Vergleich zu Logseq ab?

Beide sind lokal-zuerst und blockorientiert. Logseq ist Outliner-First mit integriertem täglichem Journaling. SiYuan ist dokumentorientiert und verfügt über Outliner-Funktionen. Logseq speichert Notizen als .md mit einer Sidecar-Datenbank; SiYuan speichert .sy JSON. Für reine Gliederungs- und tägliche Protokoll-Workflows ist Logseq der Gewinner. Für strukturierte Dokumentation und SQL-Abfragbarkeit gewinnt SiYuan.

Funktioniert SiYuan offline?

Voll. Die Desktop-App und die selbstgehostete Docker-Instanz funktionieren vollständig offline – alle Funktionen, einschließlich SQL-Abfragen, Diagrammrendering und Referenzauflösung, werden mit dem lokalen SQLite-Index ausgeführt. Für die Synchronisierung ist eine Netzwerkverbindung erforderlich (entweder zur offiziellen Cloud von

Lasst uns zusammenarbeiten

Möchten Sie AI-Systeme aufbauen, Arbeitsabläufe automatisieren oder Ihre technische Infrastruktur skalieren? Ich würde gerne helfen.

• Fiverr (benutzerdefinierte Builds und Integrationen): fiverr.com/s/EgxYmWD
• Portfolio: mejba.me
• Ramlit Limited (Unternehmenslösungen): ramlit.com
• ColorPark (Design & Branding): colorpark.io
• xCyberSecurity (Sicherheitsdienste): xcybersecurity.io