Obsidian

##仓库是普通文件夹，不是什么魔法容器

Obsidian 里的一切都发生在 vault（仓库） 上，而vault 就是一个磁盘上的普通文件夹：里面是你的 .md 笔记，外加一个 Obsidian 自己生成的 .obsidian/ 配置目录。.obsidian 目录绝对不要手动编辑或提交到公开仓库——它会记录窗口尺寸、最近打开的文件等本地状态。想换台机器继续写，只要把整个文件夹拷过去，用「打开本地仓库」指到它即可。

新建仓库的入口是启动页的 Open folder as vault；已有一个 Obsidian 仓库，也可以从仓库文件夹直接用「Open folder as vault」挂载。养成两个习惯：

• 附件、模板、附件目录都放进仓库内，用相对路径引用，换机器不会丢。
• 仓库顶层用一层子目录分类（如 daily/、projects/），不要让上千个文件平铺在根目录。

链接语法：优先用wikilink，而不是路径

双链 [[笔记名]] 是Obsidian 的核心：写 [[费曼学习法]]，Obsidian 会自动解析成指向仓库内同名的 .md 文件（不必写 .md 后缀）。链接标题可改写：[[费曼学习法|学习笔记]]。它会在后台悄悄建好文件，标题对不上时会在右侧关系面板列出「未解析链接」，这是全库最实用的自查入口。

其他三种常用变体：

嵌入语法是易错高发区：在方括号内的笔记名前加感叹号，就是嵌入笔记内容（而非只是链接），写反了会让整篇笔记被拖进正文。

常用快捷键

属性与模板

在笔记正文最前面加一段 YAML 属性块，Obsidian 会把它识别为结构化元数据，并在下方自动渲染成属性表格：

yaml---
tags: [方法论, 学习]
created: 2026-03-01
status: draft
---

属性是 Dataview 这类插件的查询基础，也是按 #标签 和属性做筛选的依据。注意属性块必须紧贴文件开头，中间隔一个空行就会失效、整段被当成普通正文。

模板则负责批量复用这种开头：设置 → 核心插件 → 模板里指定模板文件夹位置，再从命令面板执行「模板：插入模板」。日常笔记建议配一个日记模板，自动带上日期和 daily 标签。

插件：先关安全模式，再动手

社区插件默认不加载。需要先在 设置 → 第三方插件 里关闭「安全模式」，然后点「浏览」安装。装之前先想清楚一件事：插件是整个仓库范围生效的，一个插件读遍全库文件，信任成本比想象中大，建议只装确有用途的少数几个。

初次配置里值得先确认的两项：File & Links → New link format（决定新粘贴的链接用什么格式）和 Appearance → Theme，后者决定跟随系统还是自定深色浅色。