mkdocs-materialx 10.0.8

Documentation that simply works

MaterialX for MkDocs

MaterialX, the next generation of mkdocs-material, is based on mkdocs-material-9.7.1 and is named X. It continues to be maintained by individual developers (since mkdocs-material will cease maintenance)

What Difference

For a more detailed description of the differences, see documentation: Why MaterialX

Differences from Material

Aspect	mkdocs-material	MaterialX
Latest Version	mkdocs-material-9.7.1	mkdocs-materialx-10.x (based on mkdocs-material-9.7.1)
Usage	Use mkdocs.yml with the theme name material	Use mkdocs.yml with the new theme name materialx, everything else is the same as when using material
Current Status	Nearing end-of-maintenance	Active maintenance and updates
Feature Updates	None (with legacy bugs)	Bug fixes, new feature additions, UX improvements, see Changelog

Differences from Zensical

Aspect	Zensical	MaterialX
Audience	Technical developers Technical documentation	All markdown users Markdown notes & documents
Language	Rust	Python
Stage	Launched a few months ago, in early stages, basic functionality incomplete	Launched for over a decade, mature and stable
Usage	Adopt the new TOML configuration format, all configurations in the original mkdocs.yml need to be reconfigured from scratch	Continue to use mkdocs.yml with zero migration cost
Ecosystem	Built entirely from scratch, incompatible with all original MkDocs components, future development uncertain	Based on MkDocs & mkdocs-material-9.7.1, fully compatible with MkDocs' rich long-built ecosystem, open and vibrant
Core Focus	Prioritizes technical customization, with increasingly cumbersome feature configurations and ever-growing complexity in usage	Focuses on universal functions & visual presentation, extreme ease of use as primary principle, evolving to be more lightweight

Quick Start

Installation:

pip install mkdocs-materialx

Configure materialx theme to mkdocs.yml:

theme:
  name: materialx

[!NOTE] The theme name is materialx, not material. Everything else is the same as when using material.

Start a live preview server with the following command for automatic open and reload:

mkdocs serve --livereload -o

For detailed installation instructions, configuration options, and a demo, visit jaywhj.github.io/mkdocs-materialx

Chat Group

Discord: https://discord.gg/cvTfge4AUy

Wechat: