Skip to main content

笔记

Elftia 内置了一个功能完整的 Markdown 笔记系统，遵循 Zettelkasten（卡片盒）方法论，提供三种笔记类型、YAML 元数据、富文本编辑、文件夹组织、标签系统、Wiki 链接与反向引用，以及知识图谱可视化。

使用场景​

  • 在对话中随时记录灵感和想法（闪念笔记）
  • 整理阅读过的文章和论文，记录来源引用（文献笔记）
  • 将积累的知识提炼为永久性参考资料（永久笔记）
  • 通过双向链接构建个人知识网络
  • 使用知识图谱直观查看笔记之间的关联
  • 通过标签和文件夹多维度组织笔记

三种笔记类型​

Elftia 的笔记系统基于 Zettelkasten 方法论，提供三种笔记类型：

类型标识用途适用场景
闪念笔记 (Fleeting)fleeting快速记录临时想法和灵感随手记下的想法、对话中的启发、待整理的片段
文献笔记 (Literature)literature记录阅读材料的要点和笔记文章摘要、论文笔记、书籍读后感，通常带有来源 URL
永久笔记 (Permanent)permanent经过提炼的持久性知识总结性的知识条目、方法论、最佳实践

工作流程建议​

阅读/对话/灵感 → 闪念笔记（快速记录）
       ↓
  整理来源引用 → 文献笔记（关联来源）
       ↓
   提炼核心知识 → 永久笔记（持久保存）

创建笔记​

操作步骤​

  1. 打开 笔记页面（从侧边栏进入）
  2. 点击 + 按钮创建新笔记
  3. 输入笔记标题
  4. 选择笔记类型（闪念 / 文献 / 永久）
  5. （可选）选择存放的文件夹
  6. （可选）添加标签
  7. 在编辑器中编写内容
  8. 内容自动保存

笔记元数据（YAML Frontmatter）​

每个笔记文件的头部包含 YAML 格式的元数据：

---
id: a1b2c3d4-e5f6-7890-abcd-ef1234567890
type: permanent
tags:
  - AI
  - 机器学习
created: 2026-04-14T10:30:00.000Z
source_url: https://example.com/article
---
字段说明是否必填
id笔记的唯一标识符（UUID）自动生成
type笔记类型：fleeting、literature、permanent默认 fleeting
tags标签列表可选
created创建时间 (ISO 8601)自动生成
source_url来源 URL（文献笔记常用）可选

:::tip 元数据自动管理 你不需要手动编辑 YAML frontmatter。在编辑器中修改笔记类型、标签等信息时，系统会自动更新对应的元数据字段。 :::

编辑器​

笔记编辑器提供三种模式，可以根据你的习惯自由切换：

模式说明
所见即所得 (WYSIWYG)富文本可视化编辑，实时预览格式效果
Markdown 源码直接编辑 Markdown 原始文本
只读模式查看模式，以渲染后的格式展示内容

模式切换​

  • 编辑器的切换持久保存——切换笔记时不会重置
  • 在编辑器工具栏中点击模式切换按钮

Markdown 支持​

编辑器完整支持 Markdown 语法：

  • 标题（# 到 ######）
  • 粗体、斜体、删除线
  • 有序列表和无序列表
  • 代码块和行内代码
  • 引用块
  • 链接和图片
  • 表格
  • 任务列表（复选框）

文件夹组织​

笔记按文件夹层级组织在本地文件系统中。

操作​

  • 创建文件夹 — 在笔记侧边栏中点击文件夹创建按钮
  • 重命名文件夹 — 右键点击文件夹选择重命名
  • 删除文件夹 — 右键点击文件夹选择删除（需确认）
  • 移动笔记 — 将笔记移动到不同的文件夹
  • 文件夹筛选 — 在侧边栏中点击文件夹，只显示该文件夹内的笔记

笔记库（Vault）路径​

笔记存储在本地文件系统的一个目录中（称为 Vault）：

  • 默认路径 — 应用数据目录下的 notes 文件夹
  • 自定义路径 — 可以在设置中更改 Vault 路径，将笔记存储在你指定的目录

标签系统​

标签提供了文件夹之外的另一个维度来组织和检索笔记。

操作​

  • 添加标签 — 在笔记编辑时添加标签
  • 标签管理 — 在笔记页面的标签管理视图中集中管理所有标签
  • 标签颜色 — 为标签设置颜色，方便视觉区分（提供预设色板）
  • 按标签筛选 — 点击标签快速筛选包含该标签的笔记

标签颜色预设​

标签支持使用预设颜色进行视觉区分，你可以在标签管理中为每个标签选择一种颜色。

Wiki 链接与双向链接​

笔记之间可以使用 Wiki 链接语法互相关联，系统自动维护双向引用关系。

Wiki 链接语法​

在笔记内容中使用双方括号创建链接：

参考 [[其他笔记标题]] 获取更多信息。

当输入 [[ 时，编辑器会弹出笔记列表供你选择。

当笔记 A 链接到笔记 B 时，在笔记 B 的详情面板中会自动显示来自笔记 A 的反向引用，包括：

  • 链接来源笔记的标题
  • 链接所在的上下文片段
  • 来源笔记的类型

笔记详情面板也会显示当前笔记中所有指向其他笔记的链接列表。

未关联提及 (Unlinked Mentions)​

系统会检测其他笔记的内容中出现了当前笔记标题的文本，但尚未创建 Wiki 链接的情况。这些"未关联提及"会在链接面板中列出，你可以一键将其转换为正式链接。

知识图谱​

知识图谱是笔记关联关系的可视化网络图，帮助你直观理解笔记之间的连接。

查看方式​

  1. 在笔记页面切换到图谱标签页
  2. 查看力导向布局的知识图谱

图谱元素​

元素说明
节点每个节点代表一篇笔记，大小可能与连接数相关
边节点之间的连线代表 Wiki 链接关系

交互​

  • 拖拽节点调整布局
  • 点击节点跳转到对应笔记
  • 缩放和平移查看图谱全貌

搜索​

在笔记侧边栏顶部的搜索框中输入关键词，可以快速搜索笔记：

  • 搜索范围包括笔记标题和内容
  • 搜索结果实时更新
  • 支持多种排序方式

排序选项​

排序方式说明
按更新时间最近修改的排在前面
按创建时间最新创建的排在前面
按标题按标题字母顺序排列

其他功能​

功能说明
收藏将常用笔记标记为收藏，方便快速访问
重建索引当笔记文件在外部被修改后，可以手动重建索引
在文件管理器中打开快速定位笔记文件在磁盘上的位置
文件监视器自动检测外部对笔记文件的修改并同步更新索引

笔记存储架构​

笔记采用文件优先的存储架构：

  • 笔记内容以 .md 文件形式存储在本地磁盘
  • 数据库仅作为索引和缓存，用于加速搜索和关联查询
  • 你可以使用任何 Markdown 编辑器（如 Obsidian、VS Code）直接编辑笔记文件
  • 外部修改会被文件监视器自动检测并同步到索引

常见问题​

问题解决方案
笔记内容没有保存笔记内容自动保存，检查是否有文件系统权限问题
Wiki 链接不跳转确认目标笔记存在，且标题拼写正确
知识图谱为空至少需要两个笔记之间存在 Wiki 链接才会显示
反向引用不显示确认来源笔记中使用了正确的 [[标题]] 语法
外部编辑后索引不更新使用重建索引功能手动刷新
标签颜色不显示确认在标签管理中为标签设置了颜色
Vault 路径更改后笔记消失更改 Vault 路径后需要将笔记文件移到新路径

相关链接​

  • 聊天 — 在对话中引用笔记内容
  • 提示词 — 管理提示词模板
  • Agent — Agent 可以读取和创建笔记