Skip to content

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 mike only if you actually need versioned docs.