真实 Markdown 知识库

Vault 就是真实文件夹

LuckyRay 知识库读取并写入用户选择的 Markdown Vault。文档仍是磁盘上的真实 .md 文件，可以被其他兼容工具读取。

Vault 文件不复制进 LuckyRay 应用数据目录，也不会被 LuckyRay 应用备份自动复制。

笔记可引用或复制附件，并预览图片与视频。迁移 Vault 时，请同时保留它使用的附件；仅复制 .md 文件可能造成引用失效。

连接文档

• 使用 Wiki 链接连接文档
• 查看反向链接与未链接提及
• 从 Markdown frontmatter 与正文读取标签
• 使用关系图谱观察当前 Vault 的连接结构
• 在 Canvas 中引用笔记作为创作上下文

编辑与外部变更

知识库支持多标签、下一个或上一个标签切换、知识索引与文档大纲。当前文档会按编辑状态保存回真实 Markdown 文件。

如果文件在磁盘上被其他程序修改、移动或删除，LuckyRay 会重新检查文件状态。存在未保存编辑时，不会静默覆盖外部变化。

练习：建立两篇相互连接的笔记

目标是做出一篇项目简报和一篇资料笔记，并验证链接与反链。开始前确认当前知识库是你要写入的 Vault，目录可写；第一次练习可使用单独的测试目录，避免混入正式资料。

1. 01
   打开或建立 Vault

   在“知识库设置”中使用“建立仓库”或“添加已有仓库”，选定真实文件夹。已有 Markdown 文档可从“导入 Markdown 到当前仓库”加入；操作前再次确认当前仓库。

2. 02
   建立项目笔记

   通过“新建文档”创建 Campaign brief，再创建 References。回到 Campaign brief，写入下方示例。示例中的 Wiki 链接目标与第二篇文档名称一致；标签用于后续筛选。

3. 03
   验证来回导航

   打开 [[References]] 指向的笔记，补充资料摘要，然后查看“反链”，确认能回到 Campaign brief。若目标不存在，先核对名称与当前 Vault，再使用界面提供的缺失文档创建入口。

4. 04
   检查保存后的结果

   等待保存状态完成，再切换到另一篇笔记并返回。标题、正文、标签和链接都应保留。也可用其他兼容工具只读打开对应 .md 文件，确认内容确实写回磁盘。

---
tags: [campaign]
---
# Campaign brief

## Goal
Create a poster for the autumn launch.

## References
See [[References]] for source notes.

## Next action
- [ ] Choose one visual direction.

给笔记加入可迁移的附件

在“外部文件插入方式”中检查“沿用原位置”与“复制到知识库”的选择，再插入一张测试图片。前者依赖外部文件继续存在，后者为附件建立随 Vault 携带的副本；修改此选项不会自动改写已有笔记的引用。

也可以先在知识库打开目标笔记，再到素材库使用“插入当前笔记”。插入后检查图片或视频是否能预览，并确认引用的确指向想要的文件。普通 Markdown 图片语法如  只是路径示例，不会替你创建附件。

迁移前挑选一篇含附件的笔记做抽查：在目标位置打开文档，检查图片和视频，再检查 Wiki 链接。如果正文正常而附件失效，先核对附件是否一起搬走、相对目录是否保留，以及原位置是否仍可访问。

遇到外部修改时怎样选择

同一文档被其他编辑器修改时，先把当前未保存的重要文字复制到临时安全位置，再比较磁盘内容。不要同时在两个编辑器继续写同一文件；刷新索引也不等于合并两份内容。