常见文档站格式
文档站托管常卡住的地方
工具不够自由
托管型文档工具一开始很方便，但品牌、页面结构、自定义版面和最终网站控制权常会遇到限制。
Wiki 不像正式文档
Wiki 适合笔记。公开产品文档通常还需要搜索、清楚导航、自定义域名、metadata 和更好的第一印象。
自己架会吃掉工程时间
服务器、SSL、部署 hook 和发布流程不该抢走写文档的时间。
发布前先检查构建输出
上传生成后的文件夹
Docusaurus 通常输出 build，VitePress 使用 .vitepress/dist，MkDocs 输出 site。请上传生成后的文件，不是原始 Markdown。
确认 base path
如果文档站放在子路径或项目路由底下，请确认框架的 base URL 和最后网址一致。
测试搜索和导航
先在本机打开正式 build，检查搜索索引、侧边栏链接、版本路径和深层链接。
让资源适合缓存
文档站常有很多图片、字体和 JavaScript 小文件。静态部署能让这些资源更容易通过边缘节点缓存。
不只适合一种文档
开源项目文档
在品牌域名上发布教程、changelog 和迁移文档，不必把文档站变成另一个运维项目。
API 参考文档
发布干净的参考文档，保留搜索、导航和适合代码阅读的版面，比单纯生成的大页面更好扫读。
内部知识库
用清楚的网站结构托管工程手册、runbook 和流程文档。
产品文档
发布新手指南、设置教程和功能参考，让不同地区的客户都能快速开始。
设计系统
把组件用法、token 和模式整理成可导航的网站，随产品一起扩展。
支持主流静态文档工具
文档站托管常见问题
可以部署 VitePress 或 Docusaurus 输出吗？
可以。先执行框架构建，再上传生成出的静态输出文件夹。DeployPages 会提供最后的 HTML、CSS、JavaScript 和资源文件。
文档站的自定义域名怎么设置？
部署后新增域名，把 DNS 记录指向指定目标。DeployPages 会在 DNS 准备好后处理 HTTPS。
可以托管私密文档吗？
可以用密码保护做私密预览。若文档包含机密数据，请先确认分享对象、链接范围和内部审批要求；公开文档仍是最直接的发布流程。
这对 SEO 有帮助吗？
有帮助。静态 HTML、干净 URL、有效 metadata 和快速分发，能为文档的搜索可见度打好技术基础。
把文档站构建输出发布成网站
上传生成后的文件夹，给读者一个快速、可被品牌识别的查询入口。
支持 HTML、CSS、JS 和常见静态文件资源。