docs.json 中的 navigation 属性用于控制文档的结构与信息层级。
通过合理配置导航,你可以更好地组织内容,帮助用户迅速找到所需信息。
在导航的根级选择一种主要的组织方式。确定主要方式后,你可以在其内部嵌套其他导航元素。
页面

navigation 对象中,pages 是一个数组,其中每个条目都必须指向一个页面文件的路径。
分组

navigation 对象中,groups 是一个数组,其中每一项都是一个对象,每个对象都必须包含 group 字段和 pages 字段。icon、tag 和 expanded 字段是可选的。
默认展开状态
expanded 属性来控制导航侧边栏中嵌套分组的默认状态。
expanded: true:分组默认处于展开状态。expanded: false或省略:分组默认处于折叠状态。
expanded 属性只会影响嵌套分组——也就是分组中的分组。顶级分组始终是展开的,且无法折叠。选项卡

navigation 对象中,tabs 是一个数组,其中每个项都是一个对象,必须包含 tab 字段,并且还可以包含其他导航字段,例如 groups、pages、icon,或指向外部页面的链接。
navigation 对象中,menu 是一个数组,其中每个条目都是一个对象,必须包含 item 字段,并且可以包含其他导航字段,例如 groups、pages、icons,或指向外部页面的链接。
菜单项只能包含 groups、pages 和外部链接。
锚点

navigation 对象中,anchors 是一个数组,其中每个条目都是一个对象,必须包含 anchor 字段,并且可以包含其他导航字段,例如 groups、页面、icon,或指向外部页面的链接。
全局锚点
全局锚点必须包含指向外部 URL 的
href 字段,且不能包含相对路径。下拉菜单

navigation 对象中,dropdowns 是一个数组,其中每个条目都是一个对象,必须包含 dropdown 字段,并且可以包含其他导航字段,例如 groups、pages、icons,或指向外部页面的链接。
产品

navigation 对象中,products 是一个数组,其中每个条目都是一个对象,必须包含 product 字段,并且可以包含其他导航字段,例如 groups、pages、icons,或指向外部页面的链接。
OpenAPI
当你在某个导航元素(例如 anchor、tab 或 group)上添加
openapi 属性且未指定任何页面时,Mintlify 会自动为 OpenAPI 规范中定义的 所有端点 生成页面。若要控制显示哪些端点,请在 pages 数组中显式列出所需的端点。版本

navigation 对象中,versions 是一个数组,每个项都是一个对象,必须包含 version 字段,并且可包含任何其他导航相关字段。
语言

navigation 对象中,languages 是一个数组,其中每一项都是一个对象,必须包含 language 字段,并且可以包含任意其他导航字段,包括特定语言的横幅配置。
我们目前支持以下语言的本地化:

阿拉伯语(ar)

捷克语(cs)

中文(cn)

中文(zh-Hant)

荷兰语(nl)

英语(en)

法语(fr)

德语(de)

希伯来语(he)

印地语(hi)

印尼语(id)

意大利语(it)

日语(jp)

韩语(ko)

拉脱维亚语(lv)

挪威语(no)

波兰语(pl)

葡萄牙语(pt-BR)

罗马尼亚语(ro)

俄语(ru)

西班牙语(es)

瑞典语(sv)

土耳其语(tr)

乌克兰语(ua)

乌兹别克语(uz)

越南语(vi)
嵌套
docs.json 中通过 styling 属性控制站点是否启用面包屑导航。
交互配置
docs.json 中使用 interaction 属性来控制用户与导航元素的交互方式。
当用户展开一个导航分组时,某些主题会自动跳转到该分组中的第一页。你可以使用 drilldown 选项覆盖主题的默认行为。
- 设为
true:在选择导航分组时强制自动跳转到第一页。 - 设为
false:不进行跳转,选择时仅展开或折叠分组。 - 留空不设置:使用主题的默认行为。







