Obsidian 文件管理器插件 Notebook Navigator 完整使用教程
Obsidian 自带的文件浏览器简洁有余，却在视觉层面乏善可陈。打开侧边栏，看到的只是一棵文件名树——没有预览，没有缩略图，没有按日期分组的层次感，标签的浏览体验也相当有限。用久了你会发现，当库里积累到几百甚至上千篇笔记时，光靠文件名已经很难快速找到目标笔记；而在多个文件夹之间来回跳转，更是依赖大量手动点击。
Notebook Navigator 从根本上改变了这一现状。它用一套全新的双栏界面接管了 Obsidian 左侧的导航区域，左栏负责展示文件夹树和标签树，右栏以卡片式列表呈现笔记，每条笔记除了标题，还能看到预览文本、封面图、标签和时间信息。整套界面的设计思路更接近 Apple Notes 或 Bear，而不是传统的文件管理器——但它保留了 Obsidian 的全部能力，并在此之上叠加了键盘优先的快速导航、拖拽添加标签、置顶笔记、搜索过滤、逐文件夹定制排序和外观等一系列实用功能。
插件由 Johan Sanneblad 开发，于 2025 年 9 月正式上架 Obsidian 社区插件库，发布首周就在社区引发了广泛讨论。本文从安装配置讲起，逐一说明各个设置项的作用，再介绍快捷键、搜索、标签管理、样式定制和 Frontmatter 集成等进阶用法，最后补充常见问题与联动插件建议。无论你是刚开始接触这个插件，还是已经在用但想挖掘更多功能，应该都能在对应章节找到所需内容。
目录
- 插件简介与核心价值
- 前提条件
- 安装与启用
- 界面结构总览
- 基础配置：隐藏文件夹与默认排序
- 子文件夹内容聚合
- 紧凑模式与布局切换
- 快捷方式与热键
- 导航栏自定义
- 列表栏自定义
- 搜索与标签过滤
- 置顶笔记
- 图标、颜色与样式定制
- 进阶定制：颜色继承与 Style Settings
- Frontmatter 数据集成
- 与其他插件的联动
- 常见问题与注意事项
- 版本说明与平台支持
- 参考资源
1. 插件简介与核心价值
Notebook Navigator 的定位是「Obsidian 文件导航界面的完整替代方案」。它不是在原有文件浏览器上打补丁，而是将整个左侧导航区域替换为一套全新的双栏结构——左侧是导航栏（Navigation Pane），右侧是列表栏（List Pane）。
导航栏包含四个区块：快捷方式（Shortcuts）、最近文件（Recent Files）、文件夹树，以及标签树。这四个区块的顺序可以自由调整，适应不同用户的工作重心——以标签为核心的用户可以将标签树提到最上面，习惯按文件夹组织的用户则保持默认顺序即可。
列表栏展示当前选中文件夹或标签下的所有笔记，每条笔记默认显示标题、预览文本和所附标签。如果笔记内嵌有图片，插件还能自动提取第一张图作为封面图（Feature Image），让视觉繁重的库也能一眼找到目标笔记。
这套界面的核心价值体现在以下几个方面。
视觉化的笔记列表。 预览文本和封面图让每篇笔记不再只是一个名字，特别是对摄影集、设计素材库、读书笔记库这类以视觉内容为主的库，效果尤为显著。
子文件夹内容聚合。 点击任意文件夹，右侧可以同时展示该文件夹及其所有子文件夹内的笔记，并显示精确的文件计数（当前文件夹数量 / 子文件夹总数量）。同理，点击一个父级标签，可以看到该标签及其所有子标签下的全部笔记，不需要逐层展开。
键盘优先的导航体验。 通过热键绑定，可以在不离开键盘的情况下在编辑区和导航栏之间切换焦点，用方向键浏览文件夹和笔记，用快捷键直达预设的文件夹或标签，大幅减少鼠标操作。
按文件夹或标签独立定制。 每个文件夹和标签都可以单独设置排序方式、外观模式和预览行数，不依赖统一的全局默认值，适合结构复杂、不同区域有不同使用习惯的库。
大库性能保障。 插件采用虚拟化渲染和 IndexedDB 缓存，即使面对数千篇笔记的大型库，界面也能保持流畅响应，不会因为内容数量增加而明显卡顿。
2. 前提条件
Obsidian 版本。 建议使用 Obsidian 1.4 或以上版本，以获得最佳兼容性。插件依赖 Obsidian 较新版本的部分 API，过旧的版本可能导致功能异常或插件无法正常加载。
操作系统。 插件在 Windows、macOS 和 Linux 桌面端均可完整使用。移动端（Android 和 iOS）也支持基本功能，具体差异见第 18 节。
无需额外依赖。 Notebook Navigator 本身不依赖任何第三方工具或其他社区插件，安装即可使用。Style Settings 和 Featured Image 是两个可以与之配合使用的可选插件，安装后能解锁更多定制能力，但不是使用 Notebook Navigator 的前提条件。
关于库备份。 Notebook Navigator 本身不执行任何批量文件移动操作，不涉及对文件系统的破坏性修改，风险远低于附件整理类插件。但若你使用了图标或颜色数据迁移功能（将样式数据从插件设置迁移至 Frontmatter），建议操作前先备份库，以防万一。
3. 安装与启用
安装步骤与所有 Obsidian 社区插件完全相同。
第一步：关闭安全模式。 打开 Obsidian「设置」（点击左下角齿轮按钮，或按 Command/Ctrl + ,），进入「社区插件」选项卡。若安全模式处于开启状态，点击「关闭安全模式」并确认。
第二步：搜索并安装。 点击「浏览」按钮，在搜索框中输入 notebook，列表第一项即为 Notebook Navigator，点击进入详情页后点击「安装」。
第三步：启用插件。 安装完成后点击「启用」，或返回「已安装插件」列表，将 Notebook Navigator 右侧的开关拨至开启状态。
启用后，Obsidian 左侧面板会立即被 Notebook Navigator 接管。原有的文件浏览器内容不会丢失，随时可以通过禁用插件恢复到原始状态。
💡 说明 首次启用时，插件会弹出一个欢迎引导窗口，简要介绍主要功能。可以直接关闭，后续通过设置自行探索各项功能。
4. 界面结构总览
启用插件并将左侧面板调整到合适宽度后，界面会呈现为以下结构。
默认布局为单栏模式（Single Pane）。 当左侧面板宽度较窄时，插件只显示一个栏位：导航栏和列表栏通过左上角的左箭头按钮切换。这是窄屏或笔记本用户的默认状态。
切换为双栏模式（Dual Pane）。 点击左上角的返回按钮，界面顶部会出现「显示双窗格」按钮，点击即可展开双栏布局。双栏模式下，导航栏（左）和列表栏（右）同时可见，需要拖拽分隔线将左侧面板整体调宽一些，两个栏位才能舒适地并排显示。
导航栏的四个区块。 从上到下依次为：快捷方式（Shortcuts）、最近文件（Recent Files）、文件夹树（库名称折叠区块）、标签树（Tags 折叠区块）。每个区块可以折叠，顺序也可以在设置中调整。
列表栏的顶部按钮组。 从左到右依次为：搜索（Search）、显示子文件夹的文件（Show notes from subfolders & descendants）、更改排序和分组（Sort）、更改外观（Appearance）、新笔记（New note）。这五个按钮是列表栏最常用的控制入口。
文件计数标注。 在导航栏中，每个文件夹右侧会显示两个数字，格式为「当前文件夹中的笔记数 • 子文件夹中的笔记总数」。例如，显示「6 • 96」意味着当前文件夹内有 6 篇笔记，所有子文件夹中合计还有 96 篇。
5. 基础配置：隐藏文件夹与默认排序
安装完成后，建议先做两项基础配置，让界面更符合日常使用习惯。
5.1 隐藏不需要在导航栏出现的文件夹
库中常有一些辅助性文件夹，比如存放附件的 Resources 文件夹，或者存放模板的 _Templates 文件夹，它们不是笔记本身，出现在导航栏里只会干扰视线。
进入「设置 → Notebook Navigator」，找到「Hide folders」设置项，在输入框中填写需要隐藏的文件夹规则。规则支持路径前缀和通配符写法。
⚠️ 注意（特定设置） 以下为示例配置，并非通用默认值，请根据自身库结构调整。
示例：隐藏所有根目录下以下划线开头的文件夹
/_*
这条规则的含义是：路径以 / 开头（即位于库根目录），文件夹名以 _ 开头，加上 * 表示匹配任意后续字符。凡是符合这个规则的文件夹，都不会出现在 Notebook Navigator 的导航栏和列表栏中。
💡 说明（按需调整） 上述规则基于「以下划线为前缀标识辅助文件夹」的库命名约定。请根据你自己的文件夹命名方式替换规则。
| 项目 | 示例特定值 | 通用替换建议 |
|---|---|---|
| 隐藏规则 | /_* | 替换为你实际需要隐藏的文件夹路径或前缀模式 |
| 命名约定 | 下划线前缀 | 可改为任意你用于标识辅助文件夹的前缀或完整路径 |
如果你只想隐藏某一个特定文件夹，直接填写其名称即可，例如 Resources。隐藏多个文件夹时，每行填写一条规则。
如需临时查看被隐藏的文件和文件夹，点击列表栏顶部「Show hidden files」按钮，隐藏内容会暂时显示出来；再次点击则重新隐藏。
5.2 调整默认排序方式
列表栏的默认排序方式决定了笔记列表的初始呈现顺序。进入「设置 → Notebook Navigator → 列表」，找到「笔记排序方式」设置项。
插件默认为「编辑日期（最新在顶部）」。如果你更习惯按创建时间浏览笔记，可以将其改为「创建日期（最新在顶部）」。
可选的排序方式还包括标题正序/倒序、文件名正序/倒序等。这里设置的是全局默认值，每个文件夹和标签后续都可以单独覆盖这个默认排序，参见第 10 节的介绍。
6. 子文件夹内容聚合
列表栏顶部有一个名为「显示子文件夹的文件」的按钮，其在插件设置当中对应的选项是「设置 → Notebook Navigator → 列表 → 组织」当中的「显示子文件夹/后代的笔记」，这是 Notebook Navigator 中最值得优先了解的功能之一。
开启状态（默认）。 当你点击某个父文件夹，列表栏会同时展示该文件夹及其所有子文件夹中的全部笔记，汇聚在同一个列表里。导航栏中对应文件夹旁边的文件计数（如「6 • 96」）直观地显示了当前文件夹与子文件夹各自的笔记数量。
关闭状态。 列表栏只显示当前文件夹内的笔记，不包含任何子文件夹的内容。如果你进入了一个中间层文件夹（其本身没有笔记，只有子文件夹），关闭此选项后列表将是空的。
标签的聚合行为相同。 点击某个父级标签（如 #ai），开启此选项后会展示该父级标签及所有子级标签（如 #ai/tool、#ai/research）下的全部笔记；关闭后只显示严格属于 #ai 本身的笔记，不含子标签内容。
💡 说明 如果你刚安装完插件，发现列表栏里出现了大量完全不相关的笔记——这通常是因为此选项处于开启状态，而你点击的是库的根文件夹或较高层级的文件夹，导致整个库的笔记都被汇聚到了一起。此时只需点击该按钮关闭聚合，或进入更具体的子文件夹，就能回到预期的视图。
这个功能非常适合以下场景：一个项目文件夹下有多个子文件夹（比如「会议记录」「参考资料」「草稿」），开启聚合后，点击项目文件夹就能看到所有相关笔记，无需逐个进入子文件夹查找。
7. 紧凑模式与布局切换
如果你的屏幕宽度有限，或者偏好更简洁的信息密度，Notebook Navigator 提供了多种布局和显示模式可以组合配置。
7.1 切换双栏方向为垂直分割
默认的双栏布局是水平并排（Horizontal split），导航栏在左、列表栏在右。如果左侧面板整体宽度不够，可以改为垂直分割（Vertical split），两个栏位上下叠放。
进入「设置 → Notebook Navigator → 通用 → 桌面外观」，将「双栏布局方向」从「水平分割」改为「垂直分割」。
7.2 切换列表栏为紧凑模式
列表栏的默认显示模式（Standard）每条笔记会占据较大高度，方便阅读预览文本和封面图。若想在有限空间内看到更多笔记，可以切换为紧凑模式。
进入「设置 → Notebook Navigator → 列表 → 外观」，将「默认列表模式」从「标准」改为「紧凑」。紧凑模式下，每条笔记的行高大幅压缩，更接近传统文件管理器的显示密度。在紧凑模式下还可以进一步调小「精简项目高度」，在同一屏幕内容纳更多条目。
7.3 按文件类型显示图标
如果你的库中混有笔记、图片、PDF 等多种文件类型，可以开启「按文件类型设置图标」选项，让每个文件左侧显示对应类型的图标，快速区分文件类型。
进入「设置 → Notebook Navigator → 列表 → 笔记」，开启「显示文件图标」然后开启「按文件类型设置图标」。开启后，笔记、图片、PDF、视频等不同类型的文件会显示不同的图标。
7.4 在列表栏中显示当前文件夹名称
在极度紧凑的布局下，如果双栏已经叠放，导航栏可能不常可见，这时「列表窗格标题」选项可以在列表栏顶部显示当前所在文件夹或标签的名称，帮助你随时了解自己浏览的位置。
进入「设置 → Notebook Navigator → 列表」，将「外观」当中的「列表窗格标题」从「显示在标题栏」改为「显示在列表窗格」。
💡 说明（按需调整） 以上几种模式可以自由组合，并不存在唯一的「最佳配置」。建议从默认双栏水平布局出发，根据实际使用中遇到的问题逐步调整，而不必一次全部改动。
8. 快捷方式与热键
快速导航是 Notebook Navigator 的重要优势之一，完整发挥这个优势需要正确配置两类热键：插件专属热键和快捷方式编号绑定。
8.1 快捷方式区块（Shortcuts）
导航栏顶部的「Shortcuts」区块是一个可以固定常用入口的收藏夹，支持放置文件夹、标签，甚至是单篇笔记。
添加项目到 Shortcuts 的方式有三种：
- 将文件夹或标签直接拖拽到 Shortcuts 区块中；
- 点击文件夹或标签右侧的「快捷方式」快捷操作按钮，选择「添加到快捷方式」；
- 在文件夹、标签或笔记上右键点击，选择「添加到快捷方式」。
从 Shortcuts 中移除项目： 点击项目右侧的快捷操作按钮，选择移除；或右键点击选择「从快捷方式中移除」。
固定与滚动： Shortcuts 区块默认固定在导航栏顶部（Pinned），即使你向下滚动导航栏，它始终可见。如果希望它随列表滚动，可以右键点击区块标题，选择「取消固定快捷方式」。
8.2 绑定快捷方式编号热键
Shortcuts 区块中每个项目右侧会显示数字编号（1、2、3……），这些编号可以与 Obsidian 的快捷键绑定，实现一键直达。
进入「设置 → 热键（Hotkeys）」，在搜索框中输入 shortcut，找到「Notebook Navigator: Open shortcut 1」「Open shortcut 2」等条目，为它们分别绑定你希望的快捷键。
⚠️ 注意（特定设置） 以下为示例绑定方案，并非通用推荐，请根据你的键盘习惯和现有快捷键冲突情况自行调整。
示例方案：将第 1 至第 3 个 Shortcut 分别绑定到 Ctrl + 1、Ctrl + 2、Ctrl + 3。绑定后，按对应快捷键会立即跳转到该 Shortcut 对应的文件夹或标签，列表栏内容同步更新。
| 项目 | 示例绑定 | 通用替换建议 |
|---|---|---|
| Open shortcut 1 | Ctrl + 1 | 替换为你未被占用的快捷键组合 |
| Open shortcut 2 | Ctrl + 2 | 同上 |
| Open shortcut 3 | Ctrl + 3 | 同上 |
8.3 绑定「返回 Notebook Navigator」热键
这是另一个强烈推荐配置的热键。在 Obsidian 编辑区写笔记时，如果想切换回 Notebook Navigator 的列表进行导航，默认情况下需要用鼠标点击左侧面板。绑定热键后，可以直接从键盘切换焦点，不必离开手。
在「热键」设置中搜索 notebook navigator: open，找到「Notebook Navigator: Open」条目，为其绑定热键。
⚠️ 注意（特定设置） 以下绑定仅为示例。
示例绑定：Command + Shift + E（macOS）/ Ctrl + Shift + E（Windows/Linux）。
绑定后的工作流程：在编辑区写完笔记后，按此热键，焦点切换到 Notebook Navigator 的列表栏；用左方向键将焦点移至导航栏，用右方向键再移回列表栏；上下方向键在列表内上下移动；Shift + Tab 和 Tab 同样可以在两个栏位之间切换。此外，在列表中按住 Shift 同时按方向键，可以多选笔记，配合右键菜单或拖拽操作批量管理。
8.4 将「新建笔记」热键绑定到 Notebook Navigator 版本
这是一个容易被忽视但非常关键的配置。Obsidian 原生的「新建笔记」命令会根据「文件与链接」设置决定新笔记存放位置（库根目录、指定文件夹或当前笔记所在文件夹），而不是当前在 Notebook Navigator 中选中的文件夹——这与直觉预期不符。
Notebook Navigator 提供了自己版本的「新建笔记」命令，新笔记会创建在导航栏当前选中的文件夹中。
操作方式：
- 进入「设置 → 热键」，搜索
new note，找到 Obsidian 原生的「新建笔记」条目，点击右侧的「×」清除其绑定的热键（如Ctrl/Command + N）。 - 继续搜索
notebook navigator，找到「Notebook Navigator: Create new note」条目，将其绑定到刚才清除的热键（Ctrl/Command + N）。
完成后，无论你当前焦点在编辑区还是 Notebook Navigator，按 Ctrl/Command + N 创建的新笔记都会出现在导航栏当前选中的文件夹中。
9. 导航栏自定义
9.1 调整区块排列顺序
导航栏默认从上到下依次显示：Shortcuts、Recent Files、文件夹树、标签树。如果你以标签为主要组织方式，可以将标签树提升到文件夹树上方。
点击导航栏顶部的「重新排列导航」按钮，进入排序模式，拖拽各区块调整顺序后点击「完成排列」完成。
9.2 在文件夹和标签之间手动调整排列
对于不希望按字母顺序排列的文件夹或标签，可以通过右键菜单手动调整它们在导航栏中的位置，将常用的入口提到列表顶部，无需依赖字母顺序。
9.3 调整标签的排序方式
标签默认按字母顺序（A to Z）排列。当你的库中积累了大量标签时，按使用频率排序会更实用——最常用的标签自动出现在最前面。
进入「设置 → Notebook Navigator → 导航 → 标签」，打开「显示标签」选项，找到「标签排序方式」设置项，将其从「A 到 Z」改为「频率（从高到低）」。
10. 列表栏自定义
10.1 全局默认设置与逐文件夹覆盖
列表栏的排序方式、外观模式等参数有两个层级：全局默认值和每个文件夹/标签的独立覆盖值。
修改全局默认值： 进入「设置 → Notebook Navigator → 列表」，在这里修改的任何值都会成为所有文件夹和标签的默认显示行为。
为单个文件夹或标签设置独立值： 在列表栏顶部点击「更改排序和分组」按钮或「更改外观」按钮，所做的修改只影响当前文件夹或标签，不改变全局默认值。被单独设置过的文件夹，其对应的按钮会高亮显示，提示该文件夹有自定义配置。若想恢复全局默认，点击排序按钮后选择「默认」选项即可重置。
10.2 可调整的外观参数
以下参数均可在全局设置或逐文件夹层级分别配置：
列表模式（List mode）： Standard（标准）或 Compact（紧凑），控制每条笔记的高度和信息密度。
标题行数（Number of title rows）： 当笔记标题较长时，可以增加行数避免截断；若标题普遍较短，设为 1 行可节省空间。
预览行数（Number of preview rows）： 控制每条笔记下方显示的预览文本行数，可以设为 0（不显示预览）到 5 行（更详尽的内容预览）。
分组方式（Grouping）： 默认按日期分组（将笔记按「今天」「昨天」「上周」等时间段归组）；也可以改为按文件夹分组（Group by folder），或关闭分组完全以平铺列表呈现。按文件夹分组在「显示子文件夹内容」开启时尤为有用，能在聚合视图中仍然清晰地看出每篇笔记属于哪个子文件夹。
11. 搜索与标签过滤
点击列表栏顶部的搜索按钮，搜索框在列表顶部展开。
11.1 按文件名搜索
直接在搜索框中输入关键词，列表会实时过滤，只显示文件名中包含该关键词的笔记。搜索范围默认限定在当前选中的文件夹或标签内（配合「Show notes from subfolders」设置），不会跨全库搜索所有内容。
11.2 按标签过滤
在搜索框中输入 # 后接标签名（如 #50mm），列表会过滤为只包含该标签的笔记，同时导航栏中对应标签会高亮显示（绿色）。
排除标签： 在 # 前加上感叹号（!#标签名），过滤为不含该标签的笔记，导航栏中对应标签变为红色高亮，方便快速找出尚未打某个标签的笔记。这在批量补充标签时非常实用——过滤出所有「没有 #reviewed 标签的笔记」，逐一处理。
过滤无标签笔记： 搜索框中只输入 !#（不加任何标签名），可以列出所有没有任何标签的笔记，方便集中补充标签。
11.3 组合搜索（AND / OR 逻辑）
文件名关键词与标签过滤可以同时使用。例如搜索 Sony 并加上 #50mm，结果为「文件名含 Sony 且带有 #50mm 标签」的笔记。
在搜索框已有标签过滤的情况下，按住 Command（macOS）/ Ctrl（Windows/Linux）再点击导航栏中的另一个标签，该标签会以 AND 关系加入过滤条件，结果为同时带有两个标签的笔记。按住 Command + Shift 点击标签，则以 OR 关系叠加，结果为带有任一标签的笔记。
11.4 通过拖拽为笔记添加标签
搜索过滤后得到的笔记列表，可以直接拖拽单篇或多篇笔记到导航栏的标签上，将该标签添加到被拖拽的笔记中，无需打开笔记逐一编辑。
也可以右键点击笔记，选择「Add tag」，在弹出的搜索框中输入标签名，选择已有标签或新建标签，完成后立即生效。
11.5 保存常用搜索为快捷方式
搜索状态下，点击列表栏顶部的「Save search shortcut」按钮，为当前搜索条件命名，该搜索条件会作为一个新快捷方式出现在导航栏的 Shortcuts 区块中。下次点击该快捷方式，搜索条件即刻重新激活，无需重新输入。
12. 置顶笔记
对于某个文件夹内经常访问的笔记，可以将其置顶，使其始终出现在该文件夹列表的最顶部，不受排序方式影响。
置顶方式： 在列表栏中，点击笔记右侧的「快捷方式」按钮，选择「固定笔记」；或右键点击笔记，选择「固定笔记」。
置顶的作用范围： 置顶是以文件夹和标签为上下文的，也就是说，一篇笔记可以在某个文件夹视图中置顶，同时在另一个标签视图中不置顶。置顶状态在文件夹和标签之间相互独立，互不干扰。
父文件夹中的置顶笔记： 开启「显示子文件夹的文件」后，在父文件夹视图中同样可以看到子文件夹中已置顶的笔记出现在列表顶部。
13. 图标、颜色与样式定制
Notebook Navigator 允许对每一个文件夹、标签，乃至单篇笔记设置独立的图标和颜色，让导航栏在视觉上更有层次感，也更容易快速定位常用位置。
13.1 更改文件夹或标签的图标
在导航栏中右键点击任意文件夹或标签，选择「更改图标」，弹出图标选择器。在搜索框中输入关键词（支持英文），从匹配结果中点击所需图标即可应用。
默认可选的图标来源有两类：Emoji（系统表情符号）和 Lucide（Obsidian 内置的线性图标库）。
扩展图标库。 如果内置图标不够用，可以进入「设置 → Notebook Navigator → 通用 → 图标库」，下载额外的图标包。图标包数据从 Notebook Navigator 的 GitHub 仓库中获取，下载后保存在设备本地的 IndexedDB 中，不会写入任何库文件。目前可选的图标包包括 Bootstrap Icons 等。安装后在图标选择器中即可搜索新的图标。
13.2 更改文件夹或标签的颜色
右键点击文件夹或标签，选择「更改颜色」进入颜色设置，从调色板中选择所需颜色。
颜色在标签排序中的作用： 对标签设置了颜色之后，该标签会优先显示在导航栏标签列表的左侧（最前面），颜色标签排在无色标签之前，无色标签仍按字母顺序排列。这是一个快速将少数重要标签提到前排的实用技巧，无需修改任何排序设置。
对笔记同样适用：右键点击笔记，可以为单篇笔记设置专属图标和颜色，该笔记在列表栏中会以对应图标和颜色展示。
14. 进阶定制：颜色继承与 Style Settings
14.1 文件夹颜色继承
为根文件夹设置背景色后，可以让子文件夹自动继承根文件夹的颜色，形成视觉上的色块分区。
操作步骤：
- 分别右键点击多个根文件夹，通过「更改颜色」设置不同的背景色（例如蓝色、绿色、紫色等）。
- 进入「设置 → Notebook Navigator → 导航 → 文件夹」，开启「继承文件夹颜色」。
- 开启后，每个根文件夹的子文件夹会自动继承该根文件夹的颜色，导航栏在视觉上形成明显的色块分区。
这个效果配合下面的「根级项目间距」设置使用，导航栏会呈现出类似分组色块的现代外观。
14.2 根级项目间距
进入「设置 → Notebook Navigator → 导航」，调整「根级项目间距」数值，可以在导航栏根级文件夹之间添加视觉间隔，进一步增强分区感。值为 0 时没有额外间距，逐步增大可以在根项目之间产生明显空白，让不同色块之间的界限更清晰。
14.3 配合 Style Settings 进行深度定制
Notebook Navigator 完整支持 Style Settings 插件，通过它可以修改插件界面中几乎所有可视化参数，包括但不限于：
- 列表项的边框圆角（Item border radius）
- 文件计数的背景色与字体
- 字体粗细与颜色
- 各类元素的大小和间距
- 整体界面的缩放级别（Zoom level）
安装 Style Settings 插件后（在社区插件中搜索 Style Settings），进入「设置 → Style Settings」，展开顶部的「Notebook Navigator」折叠区块，即可看到所有可定制的样式参数。
缩放级别是一个特别实用的选项。 如果你觉得 Notebook Navigator 的字体和元素相对 Obsidian 整体界面偏大或偏小，可以在「设置 → Notebook Navigator → Navigation pane」中直接调整「Zoom level」，单独控制 Notebook Navigator 的 UI 比例，而不影响 Obsidian 其他区域的显示大小。
其他实用参数： 「Item height」控制导航栏每一行的高度，适合在屏幕空间有限时压缩每行占用的像素；「Tree indentation」控制子文件夹的缩进宽度，视觉层次感与紧凑度之间可以灵活取舍。
💡 说明 Style Settings 的修改结果存储在插件的配置文件中，不会写入你的笔记或 Frontmatter，随时可以在 Style Settings 设置页面重置为默认值。
15. Frontmatter 数据集成
Notebook Navigator 可以读取笔记的 Frontmatter 属性，并将这些属性用于列表栏中的显示和排序，让笔记呈现更加贴近你的实际数据结构。
15.1 启用 Frontmatter 元数据读取
进入「设置 → Notebook Navigator → 列表 → 前置元数据」，开启「使用前置元数据」选项。开启后，该设置项下方会出现多个子选项，可分别配置各类属性对应的 Frontmatter 字段名。
15.2 图标与颜色字段
开启 Frontmatter 元数据后，可以为图标和颜色分别指定 Frontmatter 字段名：
- Icon 字段： 若笔记的 Frontmatter 中包含该字段，字段值会被解析为图标，用于在列表栏中显示该笔记的图标。字段值的格式与 Iconize 插件兼容。
- Color 字段： 同理，Frontmatter 中对应字段的颜色值会直接用于列表栏中该笔记条目的颜色显示。
15.3 将图标和颜色数据保存到 Frontmatter
默认情况下，你在 Notebook Navigator 中为笔记设置的图标和颜色数据存储在插件自身的配置文件中，跨设备同步时需要将配置文件一起同步。
如果你更希望将这些数据保存到笔记的 Frontmatter 中，可以开启「Save icons and colors to frontmatter」。开启后，每次为笔记设置图标或颜色，对应字段会自动写入该笔记的 Frontmatter。
若之前已有图标和颜色数据存储在插件配置中，开启该选项后页面上会出现「Migrate」按钮，点击后插件会自动将所有已有的图标和颜色数据迁移至对应笔记的 Frontmatter，无需逐一手动设置。
15.4 自定义显示名称、创建时间和修改时间字段
你可以在 Notes 设置中配置以下字段，让 Notebook Navigator 从 Frontmatter 读取这些值，用于列表栏的显示和排序：
Name 字段（显示名称）： 若你的库使用了 Zettelkasten 等命名系统，笔记文件名可能是无意义的 ID（如 202405121430），而真正的笔记标题存放在 Frontmatter 的某个字段中（如 title）。在此处填写字段名后，列表栏中将显示该字段的值作为笔记标题，而不是文件名。
Created 字段（创建时间）： 文件系统的创建时间可能因为文件迁移、同步等操作而发生变化，导致 Obsidian 读取到的创建时间不准确。如果你的笔记 Frontmatter 中有专门记录创建时间的字段（如 created），在此处填写字段名，Notebook Navigator 将以该字段值作为排序和分组依据，而不是文件系统时间戳。
⚠️ 注意（特定设置） 上述字段名均为示例特定值，取决于你的库实际使用的 Frontmatter 字段命名习惯，并非通用默认值。
| 项目 | 示例特定值 | 通用替换建议 |
|---|---|---|
| Name 字段 | title | 替换为你实际存放笔记标题的 Frontmatter 字段名 |
| Created 字段 | created | 替换为你实际记录创建时间的 Frontmatter 字段名 |
| Modified 字段 | modified | 替换为你实际记录修改时间的 Frontmatter 字段名 |
Modified 字段（修改时间）： 同 Created 字段，可以指定 Frontmatter 中的修改时间字段，覆盖文件系统的最后修改时间作为排序依据。
16. 与其他插件的联动
16.1 Featured Image（封面图插件）
Featured Image 同样由 Johan Sanneblad 开发，与 Notebook Navigator 深度配合。它的功能是为每篇笔记自动提取或指定一张封面图，Notebook Navigator 的列表栏会将这张封面图以缩略图形式显示在笔记条目中。
在社区插件中搜索 Featured Image 安装并启用，无需额外配置，Notebook Navigator 会自动读取并展示 Featured Image 设置的封面图数据。对于摄影集、设计素材库、视频剪辑库等视觉密集型库，这个组合能大幅提升笔记识别效率。
16.2 Style Settings
如第 14.3 节所述，安装 Style Settings 插件后，可以对 Notebook Navigator 的视觉细节进行深度定制，远超内置设置的调整范围。两者的兼容性良好，是美化 Notebook Navigator 的标准搭配。
16.3 Omnisearch
Notebook Navigator 的内置搜索仅针对文件名和标签进行过滤。如果需要全文搜索（在笔记内容中搜索关键词），可以安装 Omnisearch 插件。Notebook Navigator 的设置中提供了「Omnisearch integration」选项，开启后可在 Notebook Navigator 的搜索框中触发 Omnisearch 的全文搜索结果。
16.4 Iconize
Iconize 是 Obsidian 社区中常用的图标管理插件。Notebook Navigator 的图标格式与 Iconize 兼容，这意味着如果你之前已经通过 Iconize 为文件夹配置了图标，开启 Notebook Navigator 的 Frontmatter 图标字段读取功能后，这些图标设置可以直接被识别和复用。
⚠️ 注意 两个插件同时启用时，建议统一使用其中一个管理图标，避免两套系统的图标数据产生冲突或重复。
17. 常见问题与注意事项
17.1 启用后看不到双栏布局，只有单栏
这是正常的初始状态，不是 Bug。默认显示模式由左侧面板的宽度决定：宽度较窄时自动进入单栏模式。点击左上角的返回/展开按钮后，顶部会出现「Show dual panes」按钮，点击后再将面板整体拖宽，双栏即可显示。
17.2 新建的笔记没有创建在当前选中的文件夹中
这是 Obsidian 原生「新建笔记」命令与 Notebook Navigator 不兼容的表现。请按第 8.4 节的说明，解除 Obsidian 原生「新建笔记」的热键绑定，并将其改绑定到「Notebook Navigator: Create new note」命令。
17.3 列表栏中出现了大量不相关的笔记
通常是「Show notes from subfolders and descendants」处于开启状态，且当前选中的是根目录或层级较高的文件夹，导致整个库的笔记被一次性展示。点击该按钮关闭聚合，或进入更具体的子文件夹，即可恢复正常视图。
17.4 图标选择器中找不到想要的图标
内置的 Lucide 图标库和 Emoji 不含所有类别的图标。可以通过「设置 → Notebook Navigator → Icon packs」下载 Bootstrap Icons 等扩展图标包，下载后搜索范围会相应扩大。注意图标包数据只保存在本地设备，换设备后需要重新下载。
17.5 Shortcuts 区块中的项目编号与预期不符
Shortcuts 区块中项目的编号（1、2、3……）是从上到下按顺序分配的。如果你重新排列了 Shortcuts 中项目的顺序，对应的热键绑定也需要在「设置 → 热键」中重新确认和调整，以确保热键编号与新的排列顺序匹配。
17.6 标签颜色设置后没有移到列表前排
带颜色的标签优先于无颜色的标签显示，但前提是标签排序方式设置为默认的「A to Z」或「Frequency」，且该标签确实被设置了颜色（而非只是修改了图标）。如果设置后没有效果，可以尝试重启 Obsidian 或重新加载 Notebook Navigator 使变更生效。
17.7 Frontmatter 图标迁移后，部分笔记图标消失
迁移（Migrate）操作会将插件配置中的图标数据批量写入对应笔记的 Frontmatter，但如果某些笔记处于锁定状态、被其他程序占用，或 Frontmatter 格式异常，写入可能失败。建议迁移前先备份库，迁移后检查几篇代表性笔记的 Frontmatter，确认字段已正确写入。
17.8 性能方面的注意事项
Notebook Navigator 通过虚拟化渲染和 IndexedDB 缓存来支撑大型库的性能，但初次加载时仍需要建立缓存，可能需要数秒的等待时间（视库的规模而定）。缓存建立完成后，后续启动和导航速度会显著提升。若感觉界面响应变慢，可以尝试重启 Obsidian 让缓存重新初始化。
18. 版本说明与平台支持
发布时间： Notebook Navigator 于 2025 年 9 月 15 日正式上架 Obsidian 社区插件库。
当前版本： 截至 2026 年 5 月，插件已进入活跃维护状态，作者 Johan Sanneblad 表示会持续响应 GitHub 上的 Bug 报告和功能需求，短期需求修复较快，长期功能请求也在开发路线图中。GitHub 仓库地址为 github.com/johansan/notebook-navigator。
Obsidian 版本要求： 建议使用 Obsidian 1.4 或以上版本。
桌面端（Windows / macOS / Linux）： 完整支持所有功能，包括双栏布局、自定义图标、键盘导航、Style Settings 集成、IndexedDB 缓存等全部特性。
移动端（Android / iOS）： 基本功能可用，包括浏览笔记、搜索、标签过滤和图标显示。部分高级功能（如双栏模式）在屏幕尺寸有限的设备上体验可能不及桌面端，建议在移动端以单栏模式为主。
许可证： 插件基于 GNU General Public License v3.0（GPL-3.0）开源发布。
19. 参考资源
- GitHub 仓库：
github.com/johansan/notebook-navigator（提交 Bug 或功能请求） - Obsidian 社区论坛发布帖： Obsidian Forum 搜索「Notebook Navigator is now available」可找到作者的原始介绍帖，内含功能概述和社区讨论
- 作者视频教程： Johan Sanneblad 录制了完整的入门与进阶使用视频，YouTube 搜索「Mastering Notebook Navigator for Obsidian」可直接找到
- Featured Image 插件：
github.com/johansan/obsidian-featured-image（同一作者，与 Notebook Navigator 深度配合的封面图插件） - Style Settings 插件： 在 Obsidian 社区插件库搜索「Style Settings」安装，用于深度定制 Notebook Navigator 的视觉样式
- Discord 社区： 可通过 GitHub 仓库 README 中的链接加入作者的 Discord 服务器，用于获取支持和参与讨论