结论

这个项目优先做成静态站点：内容使用 Markdown/MDX 维护，构建产物部署到 Cloudflare Pages，先用免费二级域名完成上线验证。

关键结论
  • 部署链路优先于复杂功能。
  • 内容源文件应该留在仓库中，便于版本管理。
  • 视觉表达应该组件化，而不是依赖默认 Markdown 样式。

为什么选择静态站

  • 不需要数据库和后端服务。
  • 不需要登录、鉴权或 SSO。
  • 内容可以通过 Git 做版本管理。
  • 页面可以被 CDN 缓存，访问成本和维护复杂度都更低。

本地开发命令

npm install
npm run dev
npm run build
npm run preview

部署参数

项目 值
Framework preset Astro
Build command npm run build
Output directory dist
Node.js version 使用 Cloudflare Pages 默认或项目指定版本
部署方案取舍
方案 适用场景 当前判断
Cloudflare Pages 静态站、免费二级域名、自动部署 首选
GitHub Pages 简单静态站、GitHub 原生 可选
自建服务器 需要完全控制运行环境 暂不需要

推荐推进步骤

部署优先的执行顺序
  1. 初始化 Astro + MDX 项目。
  2. 写入一篇示例文章。
  3. 本地执行构建验证。
  4. 推送到 Git 仓库。
  5. 连接 Cloudflare Pages 并完成首次部署。

后续再做

部署链路稳定后，再考虑：

  • 站内搜索。
  • 标签和专题页。
  • 阅读进度。
  • 暗色模式。
  • 更完整的 MDX 组件库。
延伸资源