Comparison Criteria
Each page below is both a concise finding and a runnable example. “Built-in” means VitePress or its default theme supplies it in this site; “Plugin” means this project installed and configured an integration; “Alternative” means a different VitePress-native approach; and “Partial” names an important limit.
| Criterion | Support | Live page |
|---|---|---|
| GFM compatibility | Partial | GFM alerts and syntax |
| Markdown extensions | Built-in + Plugin | Markdown extensions |
| MDX / MDC | Unsupported / Alternative | MDX and MDC |
| Mermaid | Plugin | Mermaid |
| Sidebar generation | Plugin | Sidebar generation |
| Local search | Built-in | Search |
| Internationalization | Built-in | i18n |
| Dark mode | Built-in | Dark mode |
| Image optimization | Partial | Image optimization |
| Asset placement | Built-in | Asset placement |
| Static site generation | Built-in | SSG |
| Docs directory placement | Built-in | Docs directory |
| Repository complexity | Moderate | Repository complexity |
| CSS customization | Built-in | Customization |
| Documentation richness | Built-in | Documentation richness |
The site overview and local-running guide give the surrounding implementation context.