docmd 提供了一个极其灵活的导航系统，可以从简单的单文件夹项目扩展到复杂的多版本、多语言文档中心。

导航定义方式

你可以通过三种方式定义导航。如果同时使用多种方式，docmd 会按照以下优先级进行解析：

1. 全局配置 (docmd.config.js)

适用于小型项目。所有导航逻辑都保存在主配置文件中。

export default {
  navigation: [
    { title: '开始使用', path: '/intro' },
    { title: 'API 参考', path: '/api', children: [...] }
  ]
}

2. 目录级配置 (navigation.json)

这是处理大规模文档的 推荐方式。在你的 docs/ 目录（或任何子目录）中放置一个 navigation.json 文件。

[
  { "title": "概览", "path": "overview.md" },
  { "title": "高级话题", "children": [...] }
]

3. 自动文件扫描 (降级方案)

如果既没有定义全局配置也没有 navigation.json，docmd 会自动扫描你的文件系统并按照字母顺序构建侧边栏。

侧边栏对象属性

每个导航项都支持以下属性：

导航解析优先级

当用户访问一个页面时，侧边栏是根据该页面所在的目录深度动态计算的：

1. 最近邻匹配: 引擎首先在当前页面所在的文件夹中查找 navigation.json。
2. 向上递归: 如果未找到，它会向父目录查找，直到到达根目录。
3. 全局降级: 如果整个文件系统中都没有 navigation.json，则使用 docmd.config.js 中的定义。

自动排序与隐藏

• 排除文件: 如果你不想让某个文件出现在自动生成的侧边栏中，但仍希望它能被访问，请在 Frontmatter 中设置 unlisted: true。
• 排序: navigation.json 中的顺序即为最终渲染的顺序。