Logseq 从一条条记录开始组织知识。每天在 Journal 写会议、阅读和任务,给关键主题建立链接,以后进入主题页,就能回看不同日期提到它的上下文。它适合边记边整理的人;若只想写一篇完整长文,块、缩进和引用的习惯需要一些适应。

先记一次会议,再把主题连起来
不必先替所有资料找好目录。下面是经典文件图谱中的简化 Markdown 示例:会议是父块,结论与任务缩进到其下,[[网站改版]] 连接主题页。示例内容是演示,不代表真实会议或实际计划:
- [[网站改版]] 讨论
- 首页介绍先说明服务对象
- TODO 整理现有栏目
- 下次讨论:导航层级
缩进表示上下文关系。把任务放在会议下面,回看时还能知道它从哪次讨论产生;若把每一句都堆在同一层,虽然也能搜索,理由与任务的关系却容易丢。Journal 负责随手记,主题页把相关记录聚起来,两者可以同时使用。

在“网站改版”页的 Linked References 中,可以找回提到这个主题的记录。页面标题保持一致,比为同一项目起几种近似名称更方便汇总;未链接提及与已建立链接也要分清,看到文字相同不等于引用关系已存在。
引用一个块,与复制一句话有什么不同
复制是留下另一份文字,后续可以独立改;引用则保留与原记录的关系。比如项目页需要展示会议里确认的规则,用块引用能回到原位置;需要展开原块及其子块时,再考虑块嵌入。原内容更新后,引用处也会随之变化,所以要保留当时结论的历史副本时,应注明日期并保存独立摘录。
- 页面链接:连接整个主题,方便从不同记录聚合相关上下文。
- 块引用:指向一条具体记录,用于复用定义、结论或任务。
- 块嵌入:在当前位置展开相关块内容,适合需要连同层级阅读的场景。
经典图谱的页面链接使用 [[页面名]],块引用采用 ((块标识))。数据库版已把页面与块统一为 node,引用使用 [[]];选择操作入口时,先确认自己使用哪一种图谱,旧教程中的语法不能不加区分地套用。
一、下载与创建 Graph:先选版本通道
稳定工作库不要直接迁入 Beta
官网下载:https://logseq.com/downloads。桌面端按 Windows、macOS 或 Linux 选择对应安装包,移动端从官方应用入口安装。官方 Release 页面同时存在旧版、Nightly 和 2.0.1 Beta;数据库版的界面与数据模型可能变化,第一次试用时建立单独的测试 Graph,不要直接把唯一的工作库交给 Beta。
经典图谱以 Markdown 或 Org Mode 文件为基础,便于用文件管理器、Git 或其他编辑器查看;数据库版需要遵循当前版本的迁移提示。升级前复制整个 Graph,包括图片、PDF、配置和插件目录,保留可以回退的副本。
经典文件图谱和数据库版,各自保留恢复路径
经典图谱:笔记文件与附件一起带走
经典图谱以 Markdown 或 Org Mode 文件为基础。备份和移动时,除页面与 Journal,还要带上图片、PDF 等附件及所需配置。换设备后文字能看到、图片却找不到,往往需要检查附件与路径,不能只复制笔记文本。
数据库版:不要按旧文件目录理解
2026 年 10 月 6 日核对时,官方最新 Release 仍是 Desktop APP 2.0.1(Beta Testing)。仓库说明数据库版处于 Beta,新移动应用和 RTC 实时协作处于 Alpha,建议独立测试图谱并保留自动备份或定期 SQLite 数据库备份。经典目录的备份方法不能直接当成数据库恢复方案。
官方数据库变化文档还说明,Org Mode 不再支持,块与页面引用、属性、表格和闪卡都有变化。需要试用时,可以先选一个不关键的项目,核对迁入后的层级、引用和附件;依赖旧查询或插件的工作库,先确认它们是否支持新数据模型,再决定迁移。
资料积累之后,再添加查询、白板和同步
查询能集中查看某类任务或记录,但前提是页面名、属性和状态写法一致。刚开始记录时,先约定常用的几种状态;确实需要跨页面找同一类资料,再按对应版本学习查询。复杂表达式无法替你修正散乱的字段命名。
PDF 高亮和白板适合把阅读资料、图片与想法放在同一上下文中,插件和主题则补充特定操作。要新增插件,先看作者说明和当前图谱类型;数据库版与经典版的兼容性不能默认一致。日常任务如果只需要记录和引用,也无需先装一整套扩展。
跨设备同步要按所用图谱及同步方案安排。经典 Sync 的说明不能直接等同于数据库版 RTC;同步会传播变化,独立备份负责恢复以前的数据。发布资料时也要看块引用、附件和反向链接是否带出私人内容,不能只检查导出首页。
- 下载与版本选择:
https://logseq.com/downloads - 经典图谱文档目录:
https://docs.logseq.com/ - 数据库状态与备份入口:
https://github.com/logseq/logseq - 数据库版变化:
https://github.com/logseq/docs/blob/master/db-version-changes.md - 2.0.1 Beta 说明:
https://github.com/logseq/logseq/releases/tag/2.0.1













暂无评论内容