总则
块
(blocks) 是 Logseq 的基本单元,一个 页面
(page) 只不过是 块
的集合。
基本功能
常用小技巧
单击
编辑任意块Enter
创建新的块Shift + Enter
创建新行/
显示所有基本命令,<
显示所有高级命令
链接
有两种链接方式:
[[Page]]
:括号链接,通常用于内联链接。如果Page
页面不存在,软件会自动创建,如果页面存在,则链接到该页面。#Hashtags
:话题标签,通常用于标记元数据。#
标签内容不能有空格,否则只能使用语法:#[[可以 有空格]]
缩进
按下 Tab
键,光标所在块会向右移动。创建父子关系,创建导航。
外部 URL
语法同 Markdown ([标题](URL)
),我的博客。
引用块
引用,而不是复制。使用引用可以减少重复,源内容更改后,引用内容自动更新。有以下方法引用某个块:
复制块引用
:右键单击目标块的项目符号,选择复制块引用
。单击并拖动块
:用鼠标单击并按住块的项目符号,然后按住Alt
键,将块拖动到指定为止。通过搜索引用
:输入三个(
,然后键入关键字,软件会自动列出有关该关键字的所有块,选择适当块引用。
引用内容会有一条下划线,为当前块的子块。
内嵌块
内嵌块可以直接修改源内容。
- 方法1:右键单击目标块的项目符号,选择
复制内嵌块
。 - 方法2:使用命令
/block embed
,然后在短代码{{embed ((关键字))}}
中输入特定的关键字,来选择合适的块。
内嵌页面
使用命令 /page embed
,得到短代码 {{embed [[页面名字]]}}
。页面嵌入会在嵌入的顶部显示页面的名称。
生产力
任务 (代办事项)
在一个块中按下 Ctrl+Enter
,自动创建任务。任务具有任务状态:
LATER
:标记任务为「稍后处理」,表示当前不需要立即行动。NOW
:标记任务为「进行中」,表示正在处理。DONE
:标记任务为「已完成」,表示任务已结束。
编辑块时,按
Ctrl + enter
可在任务状态标记之间循环。
任务可以设置 优先级
,内置三种优先级,分别使用命令 /A
、/B
、/C
进行设置:
截止日期
:使用命令 /deadline
,表示到了这个日期必须要完成的代办事项,如果超过截止日期,任务还没有完成 (需手动确认),则这个代办事项会在每天的 日志
页面中自动显示,作为提醒。
计划日期
:使用命令 /scheduled
,表示指定日期开始做的代办事项。当指定日期到来的那天,这个代办事项会在当天的 日志
页面中自动显示,作为提醒。
截止日期和计划日期也可以用于常规块,都支持将任务标记为重复。
查询
查询有两种,简单查询
和 高级查询
。
简单查询通过键入 /query
创建查询语句。语法:{{query 查询语句}}
- 按照
任务状态
查询:(task LATER)
- 按照
标签
查询:#Tag
- 指定
页面
查询:[[Page]]
- 按照
关键字
查询:"关键字"
查询运算符:
and
:(and (task now later done) [[page]]) - 查找包含任务标记(状态为 now、later 或 done 的任务)并且包含 page 页面。or
:(or [[page 1]] [[page 2]]) - 查找包含 [[page 1]] 或 [[page 2]] 任一(或两者)的页面或块。not
:(not [[page]]) - 排除掉 page 页面。
查询过滤器:
大多数过滤器都适用于块。某些过滤器仅用于页面,以下过滤器仅用于页面,不能与块过滤器混用:page
、page-property
、page-tags
、all-page-tags
。
between
:块过滤器,过滤指定时间内的内容。仅支持日志页面上的块。- 内置符号1:
today|yesterday|tomorrow|now
- 内置符号2:
+|- 数字 y|m|w|d|h|min
,比如-7d
例子:(between -2w today)、(between -7d +7d)
- 内置符号1:
page
:比如[[Page]]
:匹配页面 page 。property
:匹配页面或标记的对应属性值。全文查询
:查询用双引号包围的字符串。task
:匹配任务。比如(task now)
、(task now later)
priority
:匹配优先级。比如:(priority a b)
页面属性
:比如:related: Block embed
页面标签
:比如:#Tag
一些例子:
- 包含 “tag1”的块:{{query [[tag1]]}}
- 同时包含 “tag1”和“tag2”的块:{{query (and [[tag1]] [[tag2]])}}
- 包含“tag1”或者“tag2”的块:{{query (or [[tag1]] [[tag2]])}}
- 包含“tag2”但不包含“tag1”的块:{{query (and [[tag2]] (not [[tag1]]))}}
- 在 2020-12-05~2020-12-07日之间创建的
日志块
:{{query (between [[Dec 5th, 2020]] [[Dec 7th, 2020]] )}}
模版
以将块及其子块 创建为模板
,这样可以重复使用。比如快速生成重复结构(如日记、会议记录)。
创建模板:右键单击块点,然后单击“创建为模板”,为其命名。
使用模板:使用命令 /Template
,选择模板名称。
多媒体
添加 PDF 文件:
- 拖拽:在任何页面中创建新块,将 PDF 文件拖到新块中。
- 命令:键入“/upload an asset”并选择您的 PDF 文件。
注意:PDF 文件存储在图谱的 assets 文件夹中。目前没有自动方法可以删除它们,即使它们已取消关联。您或许可以手动删除它们以回收空间。
高亮文本:
选中文本,然后选择喜欢的颜色。可以将高亮的文本粘贴(Ctrl+v
)到任何块。
高亮区域:
按住 Shift
键,单击选择一个区域,然后选择喜欢的颜色。可以将高亮的区域粘贴(Ctrl+v
)到任何块。
白板
通过左侧边栏的“白板”按钮创建新白板。
创建白板后,
常用命令
键入 /
启动命令自动补全功能,同时也可以看到所有的基本命令。
基本命令
block embed
:内嵌块。将其他块的内容直接嵌入当前块中,显示为实时预览(内容同步更新),可以直接修改源内容。page embed
:内嵌页面。将整个页面的内容嵌入当前块中,显示为实时预览。block reference
:引用块。创建一个指向其他块的链接,点击跳转到原块。显示为实时预览,不可以修改源内容。page reference
:引用页面。创建一个指向其他页面的链接,点击跳转到该页面。link
:插入一个外部链接(URL)或内部页面链接。外部链接建议直接用 Markdown 语法,内部页面直接用[[页面]]
image link
:插入一张图片,遵循 Markdown 语法:
underline
:下划线。Markdown 不支持下划线,但可以通过 HTML 语法增加下划线。template
:模版。插入预定义的模板内容。快速生成重复结构(如日记、会议记录)。upload an asset
:上传本地文件(图片、PDF等)到 Logseq 的 assets 目录,用于添加附件到笔记。h1~h6
:标题层级,遵循 Markdown 语法。
时间和日期
- tomorrow
:插入指向明天日期的日记页面链接。
yesterday
:插入指向昨天日期的日记页面链接。today
:插入指向今天日期的日记页面链接。current time
:插入当前时间戳(格式为 HH:mm)。date picker
:通过可视化日历选择日期,插入格式为 YYYY-MM-DD 的日期文本。
任务
later
:标记任务为「稍后处理」,表示当前不需要立即行动。now
:标记任务为「进行中」,表示正在处理。done
:标记任务为「已完成」,表示任务已结束。waiting
:标记任务为「等待中」,表示依赖外部条件或他人反馈。canceled
:标记任务为「已取消」,表示任务不再需要执行。deadline
:为任务设置最后期限,到期日当天任务会出现在日志页面。scheduled
:为任务设置计划开始时间,该日期任务会出现在日志页面。
优先级
A~C
:优先级依次降低
进阶命令
query
:查询,通过自定义条件筛选块或页面。zotero
:与文献管理工具 Zotero 联动,插入文献引用或笔记,需安装 Logseq-Zotero 插件。query function
:在查询中使用函数(如日期计算、文本处理)。calculator
:在块内执行简单数学运算,实时显示结果。draw
:插入手绘图表或流程图(依赖 Excalidraw 插件)。embed HTML
:在笔记中插入自定义 HTML 代码(如表格、按钮)。embed video url
:插入在线视频(支持 YouTube、Bilibili 等),部分平台可预览。code block
:插入代码并支持语法高亮(如 Python、JavaScript)。cards
:创建间隔重复记忆卡片(类似 Anki),需配合插件,如 Flashcards 插件。cloze
:创建填空题(隐藏部分内容),用于主动回忆。
高级命令
键入 <
启动命令自动补全功能,同时也可以看到所有的高级命令。
选择命令后,它将扩展为 BEGIN…END 部分。
- quote:引用。建议使用 Markdown 语法代替本命令。
- src:代码块,和 Markdown 语法相同。
- query:定义一个高级查询块
- 额外提示,包括:
- note:注意事项
- tip:小提示
- important:重要
- caution:谨慎,建议读者谨慎行事。
- warning:警告,告知读者存在的危险、伤害或后果。
- example:将文本显示为示例,具有空白保留和不同颜色背景。
- verse:通过保留换行符来显示文本,用于诗歌。
- comment:在块中内联注释。注释正常不会显示,仅在编辑时显示。
- latex export:LaTeX 导出。将页面或块内容导出为 LaTeX 格式。
- center:居中。
- ascii:插入 ASCII 字符组成的图形或艺术文本。