VitePress 技巧

相对链接统一带 .md

写成 [快速开始](./getting-started.md) 最稳妥，构建时会被替换成正确的路由地址， 以后改文件名也能被链接检查发现。

只给某些页面加侧边栏

sidebar 用对象形式时，键是路径前缀。没有匹配到前缀的页面（比如首页）就不显示侧边栏， 所以「首页 + 多套文档」可以共存。

单独控制某页的目录层级

在 frontmatter 里覆盖全局设置：

---
outline: deep
---

outline: deep 会把三级标题也列进右侧目录，适合长文；outline: false 则完全关掉。

站点内的全文搜索

搜索索引在构建时生成，涵盖所有集合，所以多套文档共用一个搜索框， 不需要为每套文档单独配置。