# Logseq — Privacy-First Knowledge Management Platform

> Logseq is a privacy-first, open-source platform for knowledge management and collaboration. Outliner-based with bidirectional links, block references, queries, and graph visualization. Local-first with optional sync. The open-source alternative to Roam Research.

## Install

Save as a script file and run:

## Quick Use

Download from https://logseq.com/downloads or:
```bash
brew install --cask logseq                  # macOS
flatpak install com.logseq.Logseq           # Linux
```

Key concepts:
- **Journals** — daily journal pages are the default entry point
- **Blocks** — every bullet is a block with a unique ID
- **[[Links]]** — bidirectional links between pages
- **((Block refs))** — reference any block from anywhere
- **Properties** — `key:: value` on any block
- **Queries** — `{{query (and (page "project") (task TODO))}}`
- **/commands** — `/` to insert templates, dates, embeds
- **Graph view** — visualize connections between pages

## Intro

Logseq is a privacy-first, open-source knowledge management platform. Created by Tienson Qin. Based on an outliner model with bidirectional linking (inspired by Roam Research), block references, queries, and a beautiful graph view. All data stored as local Markdown or Org-mode files — no vendor lock-in.

- **Repo**: https://github.com/logseq/logseq
- **Stars**: 42K+
- **Language**: Clojure
- **License**: AGPL 3.0

## What Logseq Does

- **Outliner** — everything is a bullet/block
- **Bidirectional links** — `[[page]]` creates two-way connections
- **Block references** — embed any block in any page
- **Graph view** — visual map of connections
- **Queries** — Datalog-based queries across your knowledge base
- **Templates** — reusable block templates
- **Flashcards** — spaced repetition from blocks
- **Whiteboards** — visual canvas (beta)
- **Plugins** — 200+ community plugins
- **Local files** — Markdown or Org-mode on disk

## Architecture

Electron app + ClojureScript. Data stored as Markdown files on local filesystem. Datascript (Datalog) in-memory database indexes blocks for queries and graph. Optional Logseq Sync (E2EE) for cross-device.

## Comparison

| App | Data Model | Storage | Open Source |
|---|---|---|---|
| Logseq | Outliner + graph | Local files | Yes |
| Obsidian | Vault + plugins | Local files | No |
| Roam Research | Outliner + graph | Cloud | No |
| Notion | Database + blocks | Cloud | No |
| Joplin | Notebooks | SQLite + sync | Yes |

## FAQ

**Q: Logseq vs Obsidian?**
A: Logseq is outliner-first (journal-driven, strong block references); Obsidian is document-first (better for long-form, larger plugin ecosystem). Both use local Markdown files. Depends on your note-taking habits.

**Q: Data export?**
A: The data is simply Markdown files on your disk, directly usable. Zero migration cost.

## Sources

- Docs: https://docs.logseq.com
- GitHub: https://github.com/logseq/logseq
- License: AGPL 3.0

---
Source: https://tokrepo.com/en/workflows/logseq-privacy-first-knowledge-management-platform-42404795
Author: Script Depot