用途：obsidian.nvim 是 Neovim 的 Obsidian 仓库管理插件，本资料是配置、排错与扩展该插件的指南。
主要能力：支持多工作区（workspaces）、日记（daily_notes）、模板（templates）、Zettelkasten 风格笔记 ID、frontmatter 管理、补全（nvim-cmp 或 blink.cmp）、选择器集成（telescope、fzf-lua、mini.pick、snacks.picker）以及 UI 复选框渲染。
使用方式：以 lazy.nvim 最小安装为例，插件源为 "obsidian-nvim/obsidian.nvim"，version = "*"，ft = "markdown"，并在 opts 中配置 workspaces。系统要求 Neovim >= 0.10.0，补全与搜索需要 ripgrep（brew install ripgrep），macOS 图片粘贴需 pngpaste，Linux 需 xclip 或 wl-clipboard。常用命令包括 :Obsidian、:Obsidian today [OFFSET]、:Obsidian new [TITLE]、:Obsidian search [QUERY]、:Obsidian quick_switch、:Obsidian backlinks、:Obsidian template [NAME]、:Obsidian workspace [NAME]；可视模式下有 :Obsidian link、:Obsidian link_new、:Obsidian extract_note。补全触发符为 [[（wiki 链接）、[（Markdown 链接）、#（标签）。模板变量有 {{title}}、{{date}}、{{time}}、{{id}}，并支持自定义 substitutions。
限制与注意事项：插件需 Obsidian 处于运行且聚焦该仓库时，Neovim 的改动才会同步到 Obsidian 索引；补全源排序可能与 cmp-buffer 冲突，需调整 sorting.priority_weight；日记模板路径使用 Lua os.date 格式而非 Obsidian 自然语言格式；resolve_link() 对未索引文件返回 nil，需执行 :ObsidianRefresh；lazy.nvim 在 BufRead 上懒加载会导致首个打开的文件缺少笔记功能，应设 lazy=false 或使用 VeryLazy。可用 :checkhealth obsidian 检查，log_level = vim.log.levels.DEBUG 开启调试。