Logseq OG：传统文件式，与 Markdown 完全兼容

定位

Logseq OG 是 Logseq 的传统文件式版本，也是最早的版本形态。它的核心设计理念：你的笔记就是一堆 Markdown 文件，Logseq 只是一个比普通 Markdown 编辑器更好用的界面。

版本分离历史

2026 年初，Logseq 官方宣布把产品拆分为两个独立版本：

• Logseq OG — 传统文件式（Markdown/Org），仓库迁至 GitHub logseq/og
• Logseq DB — 新架构，图谱用数据库存储（Datascript）

拆分原因：DB 版本的很多优化（更大图谱支持、更快检索、实时同步、协作）与文件式架构存在根本冲突——无法在保持 Markdown 纯文本兼容性的同时实现这些特性。

OG 的文件结构

一个典型的 OG 图谱目录：

my-notes/
├── 2026-10-13.md              # 日记页
├── 2026-10-12.md              # 日记页
├── 深度工作.md                # 主题页面
├── CAP 定理.md                # 主题页面
├── logseq/                    # Logseq 元数据目录
│   ├── config.edn             # 图谱配置
│   └── …
├── assets/                    # 图片和 PDF 等资源
└── …

每个 .md 文件 = 一个页面；页面名 = 文件名。没有数据库、没有二进制文件——全是纯文本。

OG 的优点

1. 数据完全自由 — 任何编辑器打开，任何工具转换，Git 完美同步
2. 透明可审计 — 你打开文件就能看到所有内容，没有隐藏的内部状态
3. 工具生态 — Markdown 生态里的所有工具（编辑器、转换器、预览器）都能用
4. 不绑定 Logseq — 即使 Logseq 停更，你的笔记还是一堆 Markdown，永远可读
5. 本地优先真正落地 — 数据不经过任何服务器，同步全靠你自己的工具

OG 的局限

1. 大图谱性能 — 超过几千页后，启动和搜索速度明显变慢（DB 版本解决了这个问题）
2. 实时同步有限 — 官方 Sync 只支持 DB 版本，OG 只能用 Git/iCloud/Syncthing 等文件同步
3. 协作 — 实时协作编辑功能只在 DB 版本里有
4. 移动端 — OG 版本的移动端 App 支持较弱（DB 版本有更完善的原生 App）
5. 新功能滞后 — 白板、Flashcards 的增强功能优先在 DB 版本更新

谁适合选 OG

下载地址

OG 版本的 Desktop App 在 GitHub logseq/og 的 Releases 页面。移动端 App 标注「Logseq OG」与 DB 版本区分。