Logseq 大纲笔记¶

Logseq 是开源免费的大纲式笔记工具，一切内容都是可引用的 Block（块），日记驱动的工作流让记录变得毫无压力，双向链接让知识自然连接，是 Obsidian 之外最受欢迎的本地知识管理工具。

核心知识点¶

知识点	说明
工具定位	大纲式个人知识管理工具
最新版本	Beta 0.10.10+（2025 年 5 月）
核心优势	Block 级引用、日记驱动、开源免费
数据格式	Markdown 文件（本地存储）
重大更新	SQLite DB 版本（性能大幅提升）
定价	完全免费开源，Sync 服务 Beta 测试中

安装配置¶

# 下载安装
# 官网: https://logseq.com
# 支持 Windows / Mac / Linux / iOS / Android

# Linux 安装
# 下载 AppImage 文件
chmod +x Logseq-linux-x86_64.AppImage  # 添加执行权限
./Logseq-linux-x86_64.AppImage          # 运行

# 第一次启动
# 1. 选择存储位置（创建 Graph）
# 2. Graph = Logseq 中的知识库
# 3. 所有笔记存为 Markdown 文件在这个文件夹中

基本使用¶

1. 大纲式写作（Block = 一切）¶

# Logseq 中一切都是 Block（子弹点）

- 这是一个 Block                       # 每个子弹点是独立单元
  - 这是子 Block                        # 缩进 = 嵌套
    - 更深的嵌套                        # 可以无限嵌套
  - 另一个子 Block
- 每个 Block 都有唯一 ID               # 可以被其他地方引用
- Block 可以包含:
  - 文本、链接、图片
  - 代码块
  - LaTeX 公式
  - 嵌入其他 Block

2. 日记驱动（Journal）¶

=== 日记是 Logseq 的核心入口 ===

每天打开 Logseq，自动进入今日日记页面
不需要想"写在哪里"，直接写在日记中
需要归类的内容，用双向链接关联到对应页面

示例日记：
- 今天学了 [[宏基因组分析]] 的质控步骤
  - 用 [[fastp]] 做质量过滤
  - 参数：-q 20 -l 50
  - 结果：过滤掉 15% 的低质量 reads
- TODO 明天完成 [[物种注释]] 部分
- 读了一篇关于 [[Firmicutes]] 与 [[2型糖尿病]] 关系的论文
  - DOI: 10.1038/xxx
  - 关键发现：F/B 比值在疾病组显著升高

# 通过 [[]] 链接，信息自动归类到对应页面
# 在 [[fastp]] 页面可以看到所有提到 fastp 的日记内容

3. 双向链接与 Block 引用¶

# 页面链接
[[页面名]]                             # 链接到页面
[[页面名/子页面]]                       # 层级页面

# Block 引用（Logseq 独特功能）
((block-id))                           # 引用特定 Block
# 右键任何 Block → Copy Block Ref → 粘贴到其他地方
# 原始 Block 修改后，所有引用自动更新

# Block 嵌入
{{embed [[页面名]]}}                   # 嵌入整个页面
{{embed ((block-id))}}                 # 嵌入特定 Block

# 标签
#标签名                                # 等同于 [[标签名]]

4. 任务管理¶

# Logseq 内置任务功能

- TODO 完成质控流程                      # 待办事项
- DOING 编写分析脚本                     # 进行中
- DONE 安装 fastp                       # 已完成
- LATER 优化可视化代码                   # 稍后做
- NOW 写论文方法部分                     # 现在做

# 带截止日期
- TODO 提交论文初稿
  DEADLINE: <2026-06-01 Mon>           # 截止日期

# 带计划日期
- TODO 开始写代码
  SCHEDULED: <2026-05-15 Thu>          # 计划日期

# 查看所有任务
# 左侧边栏 → All pages → 筛选 TODO/DOING

高级用法¶

1. 查询（Query）¶

# Logseq 内置查询语言

## 查找所有未完成的 TODO
{{query (and (todo todo) (not (todo done)))}}

## 查找包含特定标签的 Block
{{query (and [[宏基因组]] [[分析]])}}

## 查找最近 7 天的日记
{{query (between -7d today)}}

## 查找带特定属性的 Block
{{query (property status "进行中")}}

## 高级查询（Datalog 语法）
#+BEGIN_QUERY
{:title "📋 所有进行中的任务"
 :query [:find (pull ?b [*])
         :where
         [?b :block/marker "DOING"]]
 :result-transform (fn [result]
   (sort-by (fn [h] (get h :block/priority "Z")) result))}
#+END_QUERY

2. 属性（Properties）¶

# 给 Block 添加结构化属性

- [[Python 数据分析]]
  type:: 课程笔记                      # 类型
  status:: 进行中                      # 状态
  priority:: 高                        # 优先级
  tags:: Python, 数据分析              # 标签
  source:: https://example.com         # 来源

# 属性可以被查询使用
{{query (and (property type "课程笔记") (property status "进行中"))}}

3. 白板（Whiteboard）¶

=== Logseq 白板功能 ===

1. 左下角 + → New whiteboard
2. 在无限画布上：
   - 拖入笔记页面
   - 画箭头连接
   - 添加文字注释
   - 绘制形状
3. 适合做思维导图和概念图

=== 使用场景 ===
- 论文结构规划
- 项目流程图
- 概念关系梳理
- 头脑风暴

4. PDF 标注¶

=== PDF 阅读与标注 ===

1. 把 PDF 文件放到 Graph 的 assets 文件夹
2. 在笔记中链接: ![](../assets/paper.pdf)
3. 打开 PDF → 高亮文字 → 自动创建标注 Block
4. 标注与笔记双向链接
5. 适合文献阅读和论文笔记

=== Zotero 集成 ===
安装 logseq-zotero-plugin
→ 从 Zotero 导入文献信息
→ 在 Logseq 中做文献笔记

5. 插件推荐¶

=== 实用插件 ===

logseq-tabs              多标签页浏览
logseq-plugin-git        Git 同步
logseq-zotero            Zotero 文献集成
logseq-kanban            看板视图
logseq-mark-map          思维导图
logseq-plugin-heatmap    贡献热图（类似 GitHub）
logseq-todomaster        任务管理增强
logseq-plugin-agenda     日程管理

=== 安装插件 ===
Settings → Plugins → Marketplace → 搜索安装

常见报错与解决¶

报错信息	原因	解决方法
Graph 加载慢	笔记太多（2000+）	等待 DB 版本或清理旧笔记
同步冲突	多设备同步问题	用 Git 或等待官方 Sync
插件不兼容	版本问题	更新 Logseq 和插件
搜索不全	索引未更新	重建索引：命令面板 → Rebuild

速查表¶

===== Logseq 速查表 =====

# 核心概念
Block = 子弹点（Logseq 的基本单元）
Page = 页面（由 Block 组成）
Graph = 知识库（所有页面的集合）
Journal = 日记（每日入口）

# 快捷键
t t          切换 TODO 状态
/ + 搜索     插入块类型
[[ + 搜索    创建/链接页面
(( + 搜索    引用 Block
Ctrl+Shift+L  全局搜索
Ctrl+Shift+G  图谱视图
Tab          缩进
Shift+Tab    取消缩进

# 任务状态
TODO → DOING → DONE
LATER → NOW → DONE

# 日期
DEADLINE: <2026-06-01>   截止日期
SCHEDULED: <2026-05-15>  计划日期

# 查询
{{query (todo todo)}}          未完成任务
{{query [[标签名]]}}            含标签的 Block
{{query (between -7d today)}}  最近 7 天

# 同步方案
iCloud / OneDrive      简单
Git + logseq-git       技术用户
Logseq Sync            官方（Beta）

# Logseq vs Obsidian
# Logseq: 大纲式、Block 引用、日记驱动、更简单
# Obsidian: 自由格式、插件更多、社区更大
# 建议：喜欢大纲 → Logseq，喜欢自由 → Obsidian