进阶用法

目录结构

docs/
├─ .vitepress/
│  └─ config.mts     ← 站点配置
├─ index.md          ← 首页(/)
├─ guide/            ← /guide/* 路由
├─ api/              ← /api/* 路由
└─ public/           ← 静态资源,原样复制到产物根

文件路由

docs/ 下的相对路径就是 URL:

文件	路由
docs/index.md	/
docs/guide/advanced.md	/guide/advanced(已开启 cleanUrls)
docs/api/user.md	/api/user

Front Matter

每个页面顶部可以用 front matter 控制标题等元信息:

---
title: 页面标题
order: 1
---

静态资源

放在 docs/public/ 下的文件按根路径引用,例如 docs/public/logo.svg → /logo.svg。