OpenSourcePicks

Open source alternatives to popular software, with live GitHub data

GitHub stats refreshed every day

Logseq

Local-first outliner with block references, backlinks and daily journals on Markdown or Org files

Open source alternative to

Visit LogseqGitHubDocumentation

Main features

  • Outliner where every bullet is a block that can be referenced and embedded
  • Page references and backlinks
  • Daily journal pages
  • Markdown or Org-mode files in the file-based version
  • Typed properties, tags with fields and queries in the DB version
  • Tasks with statuses
  • PDF annotation
  • Plugin API and themes
  • Desktop apps for Windows, macOS and Linux, plus mobile apps
  • Importer from file graphs to DB graphs
  • HTTP API, CLI and MCP server for the DB version

What Logseq does

Logseq is a personal knowledge management app built as an outliner. Every line is a block in a nested list, and any block can be referenced or embedded elsewhere, while pages link to each other and collect backlinks automatically. The app opens on a daily journal page, so the usual workflow is to write into today’s journal and let links and tags connect ideas over time. Tasks, queries and PDF annotation are built in, and a plugin API and themes extend it.

Two versions

Logseq is in the middle of a transition, and it matters which version you pick.

  • The file-based version (the 0.10.x line) stores a graph as plain Markdown or Org-mode files in a folder you choose. Any text editor can read them, and you can sync the folder with any tool you like.
  • The DB version (desktop 2.0.x releases, labeled beta, plus the web app) stores each graph in SQLite. It adds typed properties, tags that carry their own fields, richer views and queries, a CLI and an MCP server. The README warns that data loss is possible and recommends backups, and its new mobile app and real-time sync are still in alpha.

An importer converts file graphs to DB graphs, and DB graphs can be exported as a SQLite file with their assets.

Self-hosting and sync

Logseq does not need a server: the desktop apps keep everything locally and work fully offline without an account. With the file-based version the graph is an ordinary folder of text files, so you decide how, or whether, to copy it between devices. For the DB version, the documentation says Sync and Publish can be self-hosted and links to community guides, but the official route is the developers’ service.

Hosted version

Logseq Sync is a paid service that syncs graphs between devices with end-to-end encryption, using an encryption password you set, and supports real-time collaboration in the DB version. For DB graphs it is currently invite only. Logseq Publish puts selected pages online. Both are paid.

Limitations

The split between the two versions makes Logseq harder to recommend without caveats: the long-standing file version is stable, while the DB version, which brings the new features, is still beta. Official sync is paid and limited by invitation for DB graphs. The outliner model suits research notes and logs, but an outline of blocks is a less natural fit for long-form documents. It is a personal tool first; collaboration depends on sync that is still in alpha.

Who it suits

Logseq suits people who think in bullet points and links, keep a daily log, and want their notes to stay on their own devices. Choose the file-based version if plain Markdown files matter most; try the DB version if you want structured properties and can live with beta software. For a similar local-first approach with a document editor rather than an outliner, compare SiYuan; for a deep note tree, Trilium Notes.

License details

AGPL-3.0. Logseq Sync and Publish are paid hosted services by the developers.

Technical details

Built with

  • ClojureScript
  • React
  • Electron

GitHub topics

  • clojure
  • clojurescript
  • git
  • graph
  • knowledge-base
  • knowledge-graph
  • local-first
  • markdown
  • note-taking
  • org-mode
  • pkm

Reviewed by the OpenSourcePicks editors from the project's repository and documentation. Something out of date? Tell us.