Zensical

¡NOS QUITAN MKDOCS!

Este pasado 13 de abril de 2026 hubo cambios muy importantes para MkDocs y Material for MkDocs ya que se pasó a la versión 2.0 de MkDocs y en resumidas cuentas, esto provocó que ya no fuera compatible MkDocs con Materials por lo que apareció otra herramienta llamada "Zensical" para todas estas personas que lo necesitaran.

Actualmente está en constante cambio, los iré mencionando aquí

Visualmente lo que podemos ver es que cambia un poco de aspecto, teniendo la misma configuración.

1. Instalar Zensical

Haremos como con MkDocs lo único que en lugar de hacer

pip install mkdocs

haremos un

sudo apt install Zensical

2. Lanzar Zensical

Solo usaremos este comando que directamente te implementa el '--livereload'

zensical serve

3. Plugins

Como Zensical es muy actual, aun están realizando muchas configuraciones, sobre todo con los plugins.

Aunque supuestamente la mayoría son compatibles, aun están en revisión, para poder ayudarte a saber si necesitas una nueva versión de tu Zensical para instalar algún plugin, puedes consultar esta web:

https://github.com/orgs/zensical/projects/2/views/1

Visualiza la versión que tienes con:

zensical --version

Y puedes actualizar tu zensical con el siguiente comando:

Dentro del entorno python .venv

pip install --upgrade zensical

Entorno con 'source .venv/bin/activate'

4. 'zensical build'

Aquí existe un problema, al lanzar build con mkdocs lo que se quede guardado se mostrará con formato mkdocs, pero lo que modifiquemos con 'zensical build' se mostrará con zensical.

Es decir, que ciertas páginas serán mostradas con mkdocs y otras con zensical, por lo tanto debemos siempre utilizar el mismo comando.

zensical build