index.md
这是 content 里的普通 Markdown 文件(路由 /index/),不是站点主页。
站级主页是左侧栏「主页」→ /(构建产物为 index.html)。
WebMD:静态 HTML Wiki,正文嵌在页面内,Markdown 使用 GitHub 风格渲染。
布局
| 区域 | 作用 |
|---|---|
| 左 | 文件夹树(含扩展名;_res / _Res 不进树) |
| 中 | 正文 + 面包屑 + 上一页/下一页 |
| 右 | 本页大纲(窄屏折叠为「本页大纲」) |
| 顶 | 站名、文件/大纲切换、搜索(npm run build 后) |
多格式(不另写包装 md)
文件直接放进 content/:
| 类型 | 例子 | 路由 |
|---|---|---|
| Markdown | notes/hello.md |
/notes/hello/ |
| 图片 | image/1.jpg |
/f/image/1.jpg/ |
| 视频/音频 | video/*.mp4、audio/*.mp3 |
/f/.../ |
notes/sample.pdf |
/f/notes/sample.pdf/(Blob 内嵌预览) |
|
| 文本/代码 | notes/sample.txt、script/*.py |
/f/.../ 高亮 + 复制 |
原始文件始终可通过 /content/... 访问(构建后在 dist/content/)。
命令
npm install
npm run dev # 开发:与生产同模板,按需渲染完整 HTML
npm run build # 静态站 → dist/ + Pagefind
npm run preview # 预览 dist
默认端口见 vite.config.ts(18087)。
与 starlight-vanilla 对齐
左树 / 右大纲 / 分页 / 面包屑 / 拖宽收起 / 多格式预览 / 代码复制 / Pagefind 搜索 / 静态部署。