Logseq（念作 logseek /lɔːɡsiːk/）是一款本地存储的、支持 Markdown 的、大纲式的个人知识管理工具。

之前写过一篇关于 为什么选择 logseq 作为唯一的笔记工具 的文章，更多是讲“为什么 (Why)”，本文试着总结一下个人遇到的那些“怎么做 (How)”的问题。

Logseq 概览

图片

图谱及内容存储

Logseq 官方口号里的 privacy-first （隐私至上）的特性，是靠内容的本地存储来保证的。而 图谱是 Logseq 对知识库的管理模型，由 Logseq 从指定目录读取文件并组织、展示、操作。

本地目录结构

首次启动时，Logseq 会建议你“添加图谱”，选择一个目录作为存储位置。这时可以选择新建文件夹或已有文件夹，Logseq 会在基于该目录创建图谱。

Logseq 会在目录下管理以下几个子目录（如不存在则自动创建）：

journals 用于存储 日志（用于每日纪事，不是软件日志）

pages 用于存储 笔记，在 Logseq 中叫 页面

logseq 当前图谱的配置

assets 附件，可以通过 /upload 上传

whiteboards 用于存储 白板文件Logseq 中的每一条日志和笔记都对应不多于一个本地的 .md 文件。为什么是“不多于一个”？因为有的日志或笔记仅存在于图谱关联中，并没有实际内容。

关于多级目录

需要特别注意的是，Logseq 的文件存储是不使用多级目录的。所有的日志都以指定的命名格式（比如 yyyy-MM-dd.md）存储在 journals 目录下。所有的页面都使用页面的名称作为文件名（仅对特殊字符做一些转换），存储在 pages 目录下。

这里说“不使用”多级目录，而不是“不支持”多级目录，原因是你确实可以在 Logseq 外以多级目录的方式管理笔记，比如创建笔记 pages/nobs/foo.md 甚至是 notes/bar.md ，Logseq 都可以将这些笔记索引到图谱并正常编辑，只是在 Logseq 中不能直接创建笔记到多级目录。

是否使用多级目录进行笔记管理，不仅仅是风格偏好问题。在我目前的认知和实践中，不使用多级目录管理笔记能够有效降低心智负担，在记录笔记时不需要思考硬归类问题，而在整理笔记时可以通过标签体系做灵活的处理。对于某些需要严格分类的内容，我选择采用 Logseq 的伪多级目录特性来加强（见后面笔记组织一节）。

其它

Logseq 支持管理多个图谱，对应的也就是多个本地文件夹。不同图谱的笔记之间不会创建关联，所以除非各知识体系之间完全没有关联，否则不太建议使用多个图谱，不然你又会陷入到“这条笔记该记哪里”的纠结中。

有时需要对知识库重建索引，Logseq 给出的提示有点含糊且吓人：“重建索引将丢弃当前图谱，之后重新导入保存在磁盘上的所有文件。此操作将丢弃未保存的更改，同时可能需要一段时间。是否继续？”，换成不那么吓人的说法就是：“Logseq 基于磁盘文件重建图谱，任何数据都不会丢失，但可能会有点慢，继续？”。继续就是。

没有魔法，没有云服务，只有本地文件。

界面及基本操作

Logseq 采用三列式界面布局（右边栏默认隐藏），个人一般分别称为 导航区 ，内容区， 以及 辅助区 。

导航区

导航区的绝大部分内容非常直白明了，这里无须多说。

但如果你日常习惯使用笔记链接和标签系统，图谱视角是值得每天打开看看的，美妙的知识星图确实能够给你一些即时的正向反馈。

左下角的 “新页面” 按钮，实际上是“搜索或创建新页面”，对于一个笔记主题或关键字，可以使用这个功能查找跳转到原有的笔记或是新建笔记。另外，习惯使用 CTRL-K（或 CMD-K）快捷键可以提高一点效率，毕竟这个按钮的位置有点尴尬。

内容区

内容区分为上下两部分，上半部分是用来日常编辑笔记的，下半部分则是由 Logseq 管理的当前笔记的关联信息。

笔记格式是大纲式的，换句话说就是笔记支持层级式的组织方式。如果之前用过思维导图，那么这种做笔记的方式应该会很容易习惯。

对于页面来说，下半部分会展示：

Linked Reference (链接引用)，也就是所有以某种方式链接到当前笔记的内容，即 反向链接 。

如果使用了 Logseq 的伪多级目录功能，内容区下方会显示 Hierarchy （级联）的内容。对于日志来说，下半部分则默认展示任务列表。这部分内容在之前文章 使用 logseq 做任务管理 中有详细说明，包括如何做定制化。

🔨 NOW 最近进行中的待办

📅 NEXT 计划未来几天执行的待办

SCHEDULED AND DEADLINE 马上到计划/截止时间的事项

辅助区

辅助区可以同时展示多个辅助性的内容块。

展开右侧辅助区后，可以看到 Logseq 默认提供三类内容块：“目录”（默认展示内容）、“页面图谱”和“帮助”。点击相应按钮则会将内容块显示在辅助区，当然内容块也可以手动关闭。

“目录” 对应的是 Logseq 的一个特殊页面 Contents ，可以使用 “新页面”（CTRL-K 或 CMD-K）打开该页面进行编辑。个人建议使用该页面可以作为导航区的补充，以更个性化的方式组织一些快速链接。另外，推荐使用 logseq-tocgen 插件在 Contents 页内自动生成内容区笔记的目录结构，这个插件对于长文编辑大有帮助。

当使用 SHIFT+左键 打开 Logseq 链接时，链接目标会在辅助区打开。这个功能可以类比为 Logseq 内部的分屏编辑。

笔记编辑

Logseq 默认使用 Markdown 格式，基本的语法格式在 Logseq 中都适用。

常用格式

注意：非闭合型的标签，其后要加空格；闭合型的标签，建议前后都加空格。

标题 # h1 ## h2 ### h3 #### h4 ##### h5

加重 **bold** CTRL/CMD+b

斜体 *italic* CTRL/CMD+i

删除线 ~~strikethrough~~ CTRL/CMD+SHIFT+s

高亮 ^^highlight^^ CTRL/CMD+SHIFT+h

引用 > quote

链接 [link](https://url) CTRL/CMD+l

图片 

行内代码 `inline`

多行代码

```shell

echo 'So awesome~'```

待办

任何块都可以转化为待办，可以使用 ALT/OPT+Enter 将当前块在  TODO/DOING/DONE/不是待办 四种状态间切换（需要关闭 timetracking）。

如何做简单的任务管理，可以参考之前文章 使用 logseq 做任务管理 。

自动提示

输入 / 会触发 Logseq 的自动提示功能，常用的几项：

/Block embed 在当前位置嵌入内容块

/Upload an asset 上传附件并创建链接

/Tomorrow 插入明天日期链接

/CANCELED 将待办置为取消状态

/Scheduled 排定计划日期

/Deadline 排定截止时间

其它

Logseq 的大纲笔记特性决定了它使用的 Markdown 格式是一种比较特殊的 flavor ，它不靠空白行来区分段落，而是靠 -  无序号列表来间隔和层级化内容。

编辑中所有的回车（Enter）都会生成新的无序号行，如果需要保证多行文本在同一个块中，可以用 Shift+Enter 换行。

这种特殊的格式偶尔会导致外部导入的笔记在 Logseq 中无法分块的问题（一般出现在连续的多行代码时），此时可以在笔记区右上的 “...” 菜单中点击 “使用默认应用打开文件” 进行外部编辑，对于需要正常分块的行前添加 -  ，手动指定为无序号行。

另外的问题是，Logseq 没有很方便的支持有序列表（不支持 1. 语法），需要在操作区右键-“切换为有序列表” 或使用自动提示功能完成。

而表格从来都是 Markdown 的痛点之一，在 Logseq 中手动编辑更是如此，个人建议使用 logseq-markdown-table 插件编辑表格，或者在外部编辑器中进行编辑。

笔记组织

之前文章有说到，Logseq 有效降低了记笔记的心智负担，其中关键之一就是，它无缝的整合了日志和笔记两种类型的内容。在打开工具后很自然的通过记录一条日志来开始真正的知识管理（以及任务管理）。

个人知识管理的关键在于建立网状的知识结构（就是 Logseq 的图谱），而不是让知识点维持散落状态。Logseq 通过 backlink 辅助建立知识关联的前提是，你需要先创建 link 。这里就需要做一点心智模式变更，在做笔记时要适时的问自己一个问题：“这个知识点是否需要/可以与原有知识建立关联？”。

创建关联的方式可以是引用或是标签，二者在使用场景中有细微的区别。

笔记引用

Logseq 的内容根据粒度分为两个类型：页面和块，两种类型有不同的引用方式。

[[page-name]] 双方括号则可以通过标题引用页面（及日志）。输入 [[ 后 Logseq 会提示可以引用的现有笔记。

你也可以输入不存在的笔记标题，输入后点击链接 Logseq 会自动创建同名笔记。实际上这也是笔记的常用创建方式之一。

((block-id)) 双括号可以引用内容块。可以通过输入 (( 由 Logseq 提示选取，或者在块左侧的小圆点上点击右键-复制块引用。

如果选择“复制内嵌块”，则可以复制特殊格式的块引用，块的内容会在引用页自动展开展示。

标签

标签也是一种引用，直接输入 #awesome-tag 即为当前块和页同时创建了标签。注意其与标题的不同，标题中的 `#` 一定是行的首字符，且之后有一个 空格；而标签的 # 前需要有空格，而与其后的标签定义间不能有空格。

标签仅在语义上略微特殊，但在 Logseq 的存储中它也是普通的页面，可以有自己的内容。比如 #awesome-tag 这个标签，无非就是名为 pages/awesome-tag.md 的文件。

标签也可以通过 tags:: 属性的方式来创建。这种方式可以避免标签与实际的笔记内容混杂在一起。

多级

Logseq 不支持文件的多级目录结构，但是可以通过 / 分隔符来实现某种意义上的多级笔记，个人习惯称之为伪多级目录。

伪多级目录可以通过标题引用和标签两种方式达成。

在笔记标题中加入分隔符。比如，[[foo/bar/blah]] 会创建 foo 、foo/bar、 foo/bar/blah 三条笔记，在这三条笔记的内容区下方，会展示相应的 Hierarchy 级联关系。

最低层的笔记中加入标签。比如为 blah 这条笔记打上标签 #foo/bar ， Logseq 会自动创建 foo 和 foo/bar 两个标签，同样达成创建级联关系的效果。

插件推荐

作为 Logseq 的中度用户（重度使用+轻度折腾），这里列一下目前在用的插件。名称后面跟的是插件 ID。

Show Weekday and Week-number `logseq-plugin-show-weekday-and-week-number`

日志中显示当前周数

Bullet Threading `logseq-buillet-threading`

从当前活动块绘制连线直到顶级块，方便内容的定位

Markdown Table Editor `logseq-markdown-table`

表格编辑器

TOC Generator `logseq-tocgen`

生成当前文档的目录（可以放在右侧辅助区）

Awesome Content `logseq-awesome-content`

内容块美化

Awesome Links `logseq-awesome-links`

内外链显示加上 favicon

Fenced code plus `logseq-fenced-code-plus`

代码块增强，支持 Mermaid、PlantUML 画图

Bonofix Theme `logseq-bonofix-theme`

这个是主题

题图 by Shubham Dhage on Unsplash