Logseq Deep Dive

Logseq (AGPL) is the leading FOSS PKM outliner. Roam-shape — bullets are first-class, every block is addressable — but with markdown-on-disk and no subscription. Pair with pkm-overview-methodologies; contrast with pkm-obsidian-deep and pkm-org-mode-orgroam; see also selfhost-notes-wiki, prod-note-taking-consumer, prod-daily-journaling.

Why Logseq

• ★ ★ Free OSS (AGPL).
• ★ Outliner with bidirectional links — every bullet is a block; blocks are addressable; refs and embeds are native.
• ★ Markdown-on-disk by default; can also save as .org. Cross-tool friendly.
• ★ Daily journal first. Opens to today's page; press tab; you're writing. The lowest-friction PKM start.
• Free flashcards built-in — #card tag turns blocks into spaced-rep cards — see pkm-pkm-meets-anki.
• Whiteboards built in (TLDraw underneath).

The 2025 DB version (re-architecture)

• ★ Logseq DB — the new default in 2025, replacing the file-graph mode for new users. Switches the underlying store from per-file markdown to a database (with markdown export).
• File-graph mode still supported; recommended if you value strict on-disk markdown / git workflows.
• Why DB: much faster on huge graphs, properties as first-class data, mobile improvements.
• Why file-graph still: zero lock-in; dovetails with Syncthing / git; conflict resolution is line-level.
• ★ Decide upfront — you can convert, but trying both for a week before committing saves headaches.

Free / built-in features that matter

• ★ Block references / embeds — ((block-id)) references; the embed re-renders inline. The "transclude" pattern.
• ★ Queries — built-in query DSL over your graph; Datalog-flavoured. Replaces a lot of Dataview.
• Templates — built-in; /template to insert.
• Tasks — TODO, DOING, DONE, WAITING, CANCELLED, plus priority + scheduled/deadline.
• PDF annotation — built in; highlights become blocks.
• Whiteboards — TLDraw-based; spatial canvas of pages.
• Flashcards — #card becomes SRS card; review pane.
• Excalidraw plugin for hand-drawn diagrams.
• Plugin marketplace — smaller than Obsidian's but growing; AI plugins, calendar, kanban, etc.

Sync options (2026)

• ★ Syncthing for file-graph mode — see pkm-sync-storage-syncthing.
• ★ Git — Logseq has built-in git integration on desktop.
• Logseq Sync (paid) — was hosted; 2024 status uncertain after the DB pivot. Many users moved to Syncthing.
• iCloud / Dropbox / Nextcloud / OneDrive — folder-sync works fine for file-graph mode.
• Self-hosted Couchbase / CouchDB — for DB mode, community sync setups exist.

Workflow patterns

• ★ Journal-anchored capture. Every block lives on the day you wrote it; tags / refs route it to topic pages. The clearest "now what?" PKM workflow.
• ★ Block refs to build topic pages. Topic page = a few prose blocks + queries / refs to journal blocks tagged with the topic.
• Tags as namespaces — [[Project/Q3 launch]] creates a hierarchical page. PARA-friendly.
• Daily TODOs flow into project pages via queries.
• Spaced rep over notes — #card annotations; review at end of day.

Strengths vs. Obsidian

• ★ FOSS. No commercial uncertainty.
• ★ Outliner-native. If you think in bullets, this is much better than Obsidian.
• ★ Block-level addressability built in. In Obsidian you need plugins.
• Built-in queries without Dataview.
• Built-in flashcards.
• Whiteboards built in.

Weaknesses vs. Obsidian

• Smaller plugin ecosystem.
• Mobile lags Obsidian Mobile, especially on iOS.
• DB-mode confusion — the 2024-25 transition was rough; some users churned.
• Less polish — the editor has rough edges Obsidian doesn't.
• Outliner is opinionated — if you want long prose paragraphs, Logseq fights you.

Logseq + Org mode

• Logseq supports .org files as a first-class format alongside markdown.
• ★ Useful if you want Org-roam in the day, Logseq Mobile at night. Same file format, two front-ends.
• See pkm-org-mode-orgroam.

Capture & integrations

• Logseq Reader — the read-it-later side; less mature than Readwise Reader; feeds, RSS via Logseq.
• Web clipper — logseq-copilot extension exists; Markdownload also works — see pkm-capture-web-clippers.
• Readwise → Logseq plugin — daily highlight sync; see pkm-readwise-hypothesis-workflow.
• Zotero → Logseq — community plugin; see pkm-academic-zotero-workflow.

Pick this if…

• You want pure FOSS PKM: Logseq is the headliner.
• You think in outlines / bullets: Logseq > Obsidian, no contest.
• You journal daily: Logseq is the lowest-friction tool for it.
• Built-in flashcards matter: Logseq has them; Obsidian needs a plugin.
• You write long-form prose: Obsidian or Joplin — Logseq's outliner gets in the way.
• Maximum mobile polish: Obsidian.
• Roam refugee: Logseq is the closest free landing — see pkm-migration-portability.