Tool comparison¶
| MkDocs + Material | Zensical | |
|---|---|---|
| Author | Martin Donath (squidfunk) | same (Zensical LLC) |
| Maturity | mature, ~27k★, MIT | 0.0.x (0.1.0 -> 2026-11-05) |
| Plugin ecosystem | hundreds | replacements in progress |
| Versioning | mike - today |
roadmap |
| Config | mkdocs.yml |
reads mkdocs.yml |
| Content | Markdown | same Markdown |
| Best for now | publishing today | the forward path |
What changes when you switch¶
graph TD
S["Standard Markdown + mkdocs.yml"] --> M["mkdocs build"]
S --> Z["zensical build"]
In practice: nothing in the content, and at most a small mkdocs.yml/CLI adjustment.
Rules that keep it portable
- Standard
mkdocs.yml+ Material settings only. - Common Python-Markdown extensions only.
- Minimal third-party plugins.
- Use
mikeonly if you actually need versioned docs.