用 .config.yml 配置目录级侧边栏导航。

目录导航

除了单篇 Markdown 的 frontmatter,你还可以在每个内容目录下放一个 .config.yml 文件,对整个目录做配置。

目录级导航

# content/docs/guide/.config.yml
navigation:
  label: 指南
  icon: book
  description: 上手指南合集
字段类型说明
navigation.titlestring该目录在侧边栏的分组标题。
navigation.labelstring备用标签。
navigation.descriptionstring分组描述。
navigation.iconstring图标标识(由你的导航组件解释)。
navigation.hiddenboolean隐藏整个目录分组,子项也不显示。
navigation.flattenboolean把子项提升到父级,不再生成这一层分组。

hidden:隐藏分组

navigation:
  hidden: true

目录从侧边栏消失,但目录内的页面仍可通过 URL 直接访问。

flatten:展开层级

navigation:
  flatten: true

子页面会被提升到上一级,不再单独出现「目录分组 → 子项」的两层结构,适合不想多一层嵌套的场景。