# 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 是 outliner-first（日记驱动、块引用强）；Obsidian 是 document-first（长文更好、插件生态更大）。都用本地 Markdown 文件。看你的笔记习惯。

**Q: 数据导出？**
A: 数据就是 Markdown 文件在你的硬盘上，直接可用。零迁移成本。

## 来源与致谢 Sources

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

---
Source: https://tokrepo.com/en/workflows/42404795-364b-11f1-9bc6-00163e2b0d79
Author: Script Depot