数据格式:Markdown 和 Org Mode
两种格式共存
Logseq OG 版本打开图谱时,会自动识别目录里的 .md 和 .org 文件。你可以:
- 一个图谱里混用 Markdown 和 Org 文件
- 在设置里指定新建块默认用哪种格式
- 随时在设置里切换默认格式(不影响已有文件)
Markdown 格式
默认格式,也是 Logseq 社区最广泛使用的格式。
优点:
- 生态广——GitHub、Obsidian、Notion、几乎所有笔记工具都支持
- 语法简单——
-列表、#标题、**加粗**所有人都懂 - 文件对人友好——用任何文本编辑器(VS Code、记事本、Vim)打开都能读懂
- 导出/导入工具多(pandoc、markdown-it、remark 等)
Logseq 的 Markdown 扩展:
- 块级属性
key:: value(非标准 Markdown,其他工具会原样显示) - Wiki 链接
[[页面名]](Obsidian 也用这个) - Org 风格块引用(双层圆括号 block-id)(自定义语法)
- 这些扩展语法不影响基础 Markdown 渲染——在 GitHub 上能正常显示(只是
key::会被当普通文本)
Org Mode 格式
Emacs 生态的经典大纲格式,功能比 Markdown 强。
优点:
- 原生大纲结构更清晰(
******表示层级) - 内置 TODO 状态(比 Markdown 的
- [ ]更丰富) - 日程管理、表格、属性等功能原生支持
- 对 Emacs 用户无缝对接
缺点:
- 生态小——GitHub 等平台对 Org 支持有限
- 语法更复杂(Emacs 用户熟悉,其他人需要学习)
- Logseq 里 Org 和 Markdown 混用时偶尔有兼容问题
格式选择建议
| 你是 | 推荐格式 | 原因 |
|---|---|---|
| 普通笔记用户 | Markdown | 通用、简单、生态广 |
| 从 Obsidian 过来 | Markdown | 无缝迁移,语法一致 |
| 长期想把数据完全自由掌控 | Markdown | 最多工具可读 |
| Emacs 用户 / Org 老用户 | Org Mode | 原生无缝 |
| 学术研究者(用 Emacs + Org) | Org Mode | 比 Markdown 强很多 |
在其他编辑器里打开 Logseq 的 md 文件
完全可以。VS Code + 一些 Markdown 插件(Markdown All in One、Markdown Preview Enhanced)打开 Logseq 的 md 文件能正常显示:
-列表正常渲染**加粗**# 标题[[]]链接都能正常预览key:: value属性会被当普通文本显示(这是正确的——其他工具不知道那是 Logseq 的属性语法)- 双层圆括号块引用也会被当普通文本
这正是 Logseq 隐私优先理念的体现:你的数据永远是纯文本,Logseq 只是它的最好用的一个编辑器。
Logseq DB 版本的差异
DB(Database)版本的数据不再是纯 Markdown 文件——它用数据库存储块和页面。这意味着:
- DB 版本的数据不能直接用外部编辑器打开
- 需要通过 Logseq 的导出功能导出为 Markdown
- DB 版本的同步和检索性能更好,但牺牲了「纯文本可移植性」
如果你在意数据自由掌控,优先选 OG 版本(Markdown)。
格式 vs 版本形态
不要混淆这两个维度:
- Markdown vs Org Mode — 文件格式(OG 版本的两个选项)
- OG vs DB — 架构形态(整个 Logseq 的两套版本)
OG 版本里选 Markdown 还是 Org;DB 版本里数据存在数据库里、不再有格式选择。