⚛️
Use React in Markdown
Render React components directly inside VitePress Markdown pages while keeping existing JSX, TSX, and TypeScript workflows.
Docs Islands for VitePress
Cross-framework Islands Architecture for VitePress
Skip to content
🎯
Per-component Rendering Strategies
Choose `ssr:only`, `client:load`, `client:visible`, or `client:only` per component instead of turning the whole page into a separate app.
⚡
Smoother SPA Route Changes
`spa:sync-render` lets selected components land earlier during route changes so flicker and layout shift stay under control.
🚀
Keep the Static-site Model
The site still follows the VitePress static-generation model, and client takeover only happens where interaction is actually needed.
🛠️
Fits the VitePress Workflow
React components, Markdown content, and theme extensions stay in one documentation workflow with aligned `HMR` and build behavior.
🔎
Site DevTools
Inspect page overlays, debug logs, bundle composition, and build reports when you need to understand rendering, `HMR`, or asset cost.
Are you an LLM? View /docs-islands/vitepress/llms.txt for optimized Markdown documentation, or /docs-islands/vitepress/llms-full.txt for full documentation bundle