scrollup.io

是什么

ScrollUp 是一个基于 Astro 的开源文档框架，采用 MIT License，定位是帮助开发者和技术写作者用 MDX 快速构建美观、快速的静态文档站点。它生成纯静态 HTML，不依赖服务器运行时，适合 API、SDK、CLI 文档、SaaS 产品帮助中心和 Git 仓库管理的内部知识库。

核心能力

内容层面，ScrollUp 支持 Markdown 与 JSX 组件混写，内置 Callout、Steps、Tabs、代码块、卡片、文件树等组件，减少额外插件配置。搜索使用 Orama 在构建期生成索引、浏览器端运行，优点是无需外部服务和 API Key。主题方面提供浅色、系统、深色三态切换，并强调颜色不是简单反转。国际化方面内置 en、fr、es、de、ja、hi 等 UI chrome，并通过 content/docs/{locale}/ 组织内容。

部署、API 与生态

ScrollUp 只支持 Astro 的 static 输出模式，可部署到 Vercel、Netlify、Cloudflare Pages、GitHub Pages、GitLab Pages，也明确支持 Self-hosted。CLI 主要由 npm 脚本组成，包括 dev、build、preview、setup、new-page、validate、check-links、check-freshness，覆盖本地开发、构建、页面脚手架、链接检查和内容新鲜度检查。生态集成包括 Astro、@astrojs/mdx、Expressive Code、Orama、GitHub 编辑链接以及插件系统。

定价与优缺点

正文未出现商业定价、托管套餐或企业支持信息；结合 MIT License，可视为开源免费使用。优点是功能组合完整、静态部署灵活、无外部搜索依赖、文档示例充分。局限是仅支持静态输出；部分配置如 section 顺序仍需修改代码；大型文档集下客户端搜索的性能边界没有说明；也未看到版本化文档、权限控制或官方商业支持。

适合谁与中国访问

ScrollUp 适合熟悉 Git、Node.js、Astro/MDX 工作流的开发团队和技术写作者，尤其是需要把文档纳入代码仓库、通过 CI/CD 发布的团队。中国访问情况正文未提供，域名与 GitHub、Vercel、Netlify、Cloudflare 等依赖在国内可能受网络环境影响；若部署到自有服务器或国内静态托管，可降低访问不确定性。可替代方案包括 Docusaurus、VitePress、Astro Starlight、Nextra 和 MkDocs Material。