Docs Islands for VitePress

为 VitePress 提供跨框架群岛架构

⚛️

在 Markdown 中使用 React

直接在 VitePress Markdown 文件中导入和使用 React 组件，无需额外配置。支持 JSX/TSX，完整的 TypeScript 类型支持。

🎯

目前支持 ssr:only（默认，纯静态）、client:load（立即水合）、client:visible（可见时水合）、client:only（纯客户端），可扩展更多策略。

⚡

spa:sync-render 指令专为 VitePress SPA 模式设计，与 Vue 渲染周期同步预渲染模板，消除路由切换时的组件闪烁，优化 CLS 指标。

🚀

基于 VitePress SSG 架构，构建时预渲染组件模板。仅在需要交互的地方进行选择性客户端水合，优化首屏性能。

🧩

与 VitePress 主题、插件无缝集成，不破坏原有功能。支持 MPA 模式，可在任何 VitePress 项目中使用。

🛠️

完整的 HMR 支持，React 组件和 Markdown 文件修改即时热更新，组件内部状态保持不丢失。开发/生产环境渲染行为一致，避免生产环境意外。