Comparison criteria
“Native” means Docusaurus core or the classic/official Mermaid theme provides the behavior. “Community” marks an installed third-party integration.
| Criterion | Classification | Live page |
|---|---|---|
| GFM | Partial native | GFM |
| Markdown extensions | Native | Markdown extensions |
| MDX / MDC | Native MDX / no MDC | MDX and MDC |
| Mermaid | Official theme | Mermaid |
| Sidebar generation | Native | Sidebar generation |
| Search | Community, offline | Search |
| i18n | Native | Internationalization |
| Dark mode | Native theme | Dark mode |
| Image optimization | Partial | Image optimization |
| Asset placement | Native | Asset placement |
| SSG | Native | Static generation |
| Docs directory | Configurable | Docs placement |
| Repository complexity | Moderate | Complexity |
| Customization | Native extension points | Customization |
| Documentation richness | Rich | Documentation |