Skip to content

Switch from MkDocs to Zensical for documentation build #24

@AndrewSazonov

Description

@AndrewSazonov

Warning from the Material for MkDocs team:

MkDocs 2.0, the underlying framework of Material for MkDocs, will introduce backward-incompatible changes, including:

  • All plugins will stop working – the plugin system has been removed
  • All theme overrides will break – the theming system has been rewritten
  • No migration path exists – existing projects cannot be upgraded
  • Closed contribution model – community members can't report bugs
  • Currently unlicensed – unsuitable for production use

MkDocs team full analysis:
https://squidfunk.github.io/mkdocs-material/blog/2026/02/18/mkdocs-2.0/

So, we need to do this switch once Jupyter Notebooks are supported. More links:

Metadata

Metadata

Assignees

No one assigned

    Labels

    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions