wiki 的目录与命名:三层以内,路径就是导航
一、四家产品的目录模型
| 产品 | 层级 | 说明 |
|---|---|---|
| Wiki.js | 路径即目录 | 页面路径 /universe/planets/earth 自动推断层级,面包屑自动生成 |
| BookStack | 固定三层 | Book → Chapter → Page,不能再深 |
| Docmost | 三级 | Workspace → Space → Page,Page 之间还能嵌套 |
| Outline | 集合 + 嵌套文档 | Collection 下挂文档,文档内可再嵌套子文档 |
这四个模型里,我最喜欢 Wiki.js 的「路径就是目录」:不用手工建文件夹,页面放在哪个路径就属于哪一级,改路径等于改结构。代价是改名会让旧链接 404,需要重定向或保留别名。

图:Wiki.js 文档的 Folder Structure & Tags 页:路径 /universe/planets/earth 会自动推断层级,面包屑自动生成
二、我用的命名规则
- 路径:全小写英文,单词之间用短横线,不用下划线、不用中文;
- 标题:写用户会搜的结果句,比如「MySQL 8 升级前检查清单」,不写「关于升级的说明」;
- 日期:只进正文,不进路径,避免每年重建一次目录;
- 标签:同义词放标签,比如 nginx 和 反向代理,别在路径里堆同义词;
- 一页只讲一件事,超过三屏就拆页。
三、三种我拆过的坏目录
第一种按人名建目录:人一离职,目录就成了遗迹,内容也没人维护。第二种按年份建目录:2024、2025、2026 越堆越多,同一主题被切碎。第三种把首页当导航:所有链接堆在首页,改一次结构要动几十个页面。
替代做法是:按稳定的领域建一级目录,比如 ops、product、support;年份和负责人写进页面属性或正文;首页只放搜索框和三个最常用入口。
四、一套可以直接抄的目录样例
技术团队我一般开三个一级目录:ops 放服务器、发布、备份;product 放需求、设计、验收;support 放客服话术和排障。二级按子系统或阶段分,比如 ops/mysql、ops/nginx、product/pay。三级就是具体页面,超过三级的内容用标签和站内链接串起来,不再往下建。
标签我控制在 30 个以内,每个页面最多 3 个;标签只放「找内容」的维度,比如 mysql、备份、故障,不放「谁写的」「哪一年」这类会过期的信息。目录负责稳定,标签负责灵活,两者不要互相替代。
五、改名怎么不坏链接
Wiki.js 改路径后旧地址会 404,要么在反向代理加 301,要么保留旧页面做跳转;BookStack 的页面 slug 可改,旧链接同样要重定向;Docmost 和 Outline 以页面 ID 为主,改标题一般不影响链接。改名前先导出站内链接清单,改完跑一遍死链检查。
五、我的判断
50 页以内别做目录,搜索加标签就够;200 页以上必须有稳定路径规则,并且写进新人手册。目录是给未来的自己看的,不是给文件夹审美看的。
网友评论