笔记
Elftia 内置了一个功能完整的 Markdown 笔记系统，遵循 Zettelkasten（卡片盒）方法论，提供三种笔记类型、YAML 元数据、富文本编辑、文件夹组织、标签系统、Wiki 链接与反向引用，以及知识图谱可视化。
使用场景
- 在对话中随时记录灵感和想法（闪念笔记）
- 整理阅读过的文章和论文，记录来源引用（文献笔记）
- 将积累的知识提炼为永久性参考资料（永久笔记）
- 通过双向链接构建个人知识网络
- 使用知识图谱直观查看笔记之间的关联
- 通过标签和文件夹多维度组织笔记
三种笔记类型
Elftia 的笔记系统基于 Zettelkasten 方法论，提供三种笔记类型：
| 类型 | 标识 | 用途 | 适用场景 |
|---|---|---|---|
| 闪念笔记 (Fleeting) | fleeting | 快速记录临时想法和灵感 | 随手记下的想法、对话中的启发、待整理的片段 |
| 文献笔记 (Literature) | literature | 记录阅读材料的要点和笔记 | 文章摘要、论文笔记、书籍读后感，通常带有来源 URL |
| 永久笔记 (Permanent) | permanent | 经过提炼的持久性知识 | 总结性的知识条目、方法论、最佳实践 |
工作流程建议
阅读/对话/灵感 → 闪念笔记（快速记录）
↓
整理来源引用 → 文献笔记（关联来源）
↓
提炼核心知识 → 永久笔记（持久保存）
创建笔记
操作步骤
- 打开 笔记页面（从侧边栏进入）
- 点击 + 按钮创建新笔记
- 输入笔记标题
- 选择笔记类型（闪念 / 文献 / 永久）
- （可选）选择存放的文件夹
- （可选）添加标签
- 在编辑器中编写内容
- 内容自动保存
笔记元数据（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 链接语法
在笔记内容中使用双方括号创建链接：
参考 [[其他笔记标题]] 获取更多信息。
当输入 [[ 时，编辑器会弹出笔记列表供你选择。
反向引用 (Backlinks)
当笔记 A 链接到笔记 B 时，在笔记 B 的详情面板中会自动显示来自笔记 A 的反向引用，包括：
- 链接来源笔记的标题
- 链接所在的上下文片段
- 来源笔记的类型
正向引用 (Outlinks)
笔记详情面板也会显示当前笔记中所有指向其他笔记的链接列表。
未关联提及 (Unlinked Mentions)
系统会检测其他笔记的内容中出现了当前笔记标题的文本，但尚未创建 Wiki 链接的情况。这些"未关联提及"会在链接面板中列出，你可以一键将其转换为正式链接。
知识图谱
知识图谱是笔记关联关系的可视化网络图，帮助你直观理解笔记之间的连接。
查看方式
- 在笔记页面切换到图谱标签页
- 查看力导向布局的知识图谱
图谱元素
| 元素 | 说明 |
|---|---|
| 节点 | 每个节点代表一篇笔记，大小可能与连接数相关 |
| 边 | 节点之间的连线代表 Wiki 链接关系 |
交互
- 拖拽节点调整布局
- 点击节点跳转到对应笔记
- 缩放和平移查看图谱全貌
搜索
在笔记侧边栏顶部的搜索框中输入关键词，可以快速搜索笔记：
- 搜索范围包括笔记标题和内容
- 搜索结果实时更新
- 支持多种排序方式
排序选项
| 排序方式 | 说明 |
|---|---|
| 按更新时间 | 最近修改的排在前面 |
| 按创建时间 | 最新创建的排在前面 |
| 按标题 | 按标题字母顺序排列 |
其他功能
| 功能 | 说明 |
|---|---|
| 收藏 | 将常用笔记标记为收藏，方便快速访问 |
| 重建索引 | 当笔记文件在外部被修改后，可以手动重建索引 |
| 在文件管理器中打开 | 快速定位笔记文件在磁盘上的位置 |
| 文件监视器 | 自动检测外部对笔记文件的修改并同步更新索引 |
笔记存储架构
笔记采用文件优先的存储架构：
- 笔记内容以
.md文件形式存储在本地磁盘 - 数据库仅作为索引和缓存，用于加速搜索和关联查询
- 你可以使用任何 Markdown 编辑器（如 Obsidian、VS Code）直接编辑笔记文件
- 外部修改会被文件监视器自动检测并同步到索引
常见问题
| 问题 | 解决方案 |
|---|---|
| 笔记内容没有保存 | 笔记内容自动保存，检查是否有文件系统权限问题 |
| Wiki 链接不跳转 | 确认目标笔记存在，且标题拼写正确 |
| 知识图谱为空 | 至少需要两个笔记之间存在 Wiki 链接才会显示 |
| 反向引用不显示 | 确认来源笔记中使用了正确的 [[标题]] 语法 |
| 外部编辑后索引不更新 | 使用重建索引功能手动刷新 |
| 标签颜色不显示 | 确认在标签管理中为标签设置了颜色 |
| Vault 路径更改后笔记消失 | 更改 Vault 路径后需要将笔记文件移到新路径 |