WebMD
本页大纲

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/*.mp4audio/*.mp3 /f/.../
PDF notes/sample.pdf /f/notes/sample.pdf/(Blob 内嵌预览)
文本/代码 notes/sample.txtscript/*.py /f/.../ 高亮 + 复制

原始文件始终可通过 /content/... 访问(构建后在 dist/content/)。

命令

npm install
npm run dev       # 开发:与生产同模板,按需渲染完整 HTML
npm run build     # 静态站 → dist/ + Pagefind
npm run preview   # 预览 dist

默认端口见 vite.config.ts18087)。

与 starlight-vanilla 对齐

左树 / 右大纲 / 分页 / 面包屑 / 拖宽收起 / 多格式预览 / 代码复制 / Pagefind 搜索 / 静态部署。