Zensical modern static site generator for project documentation (successor to Material for MkDocs). This skill should be used when creating or editing Zensical documentation sites, writing zensical.toml configuration, authoring Markdown with Zensical extensions (admonitions, code blocks, content tabs, grids, diagrams, math), migrating from mkdocs-material to Zensical, setting up Docker or uv development workflows, configuring live preview with zensical serve, building production Docker images, publishing to GitHub Pages or GitLab Pages, configuring site search, navigation features, theming (colors/fonts/logo), customizing Zensical sites with CSS/JS overrides, using Snippets for content reuse (include-markdown substitute), or generating API docs with mkdocstrings.
Modern static site generator by the makers of Material for MkDocs. Written in Rust and Python, published as a Python package. Uses zensical.toml (TOML) for configuration instead of mkdocs.yml (YAML), though legacy YAML is supported for migration.
| Topic | Reference |
|---|---|
| Installation (pip, uv, Docker) | installation.md |
Project config (zensical.toml, extensions) | project-config.md |
| Dev workflow (serve, build, CLI) | dev-workflow.md |
| Publishing (GitHub/GitLab Pages) |
| publishing.md |
| Navigation & site search | navigation-search.md |
| Theming & customization | theming.md |
For CI/CD pipeline details, reference the /github or /gitlab-ci skills.
| Topic | Reference |
|---|---|
| Admonitions (callouts) | admonitions.md |
| Code blocks & content tabs | code-blocks-tabs.md |
| Grids (card & generic) | grids.md |
| Text formatting & buttons | formatting-text.md |
| Images, icons, diagrams, math | media-diagrams.md |
| Front matter, tags, tables, lists, footnotes, tooltips | metadata-elements.md |
| Topic | Reference |
|---|---|
| Content reuse (Snippets, include-markdown substitute) | content-reuse.md |
| API documentation (mkdocstrings) | mkdocstrings.md |
Config conversion from mkdocs.yml to zensical.toml, feature parity status, extension compatibility, theme overrides, analytics, and plugin substitutes.
zensical.toml) instead of YAML (mkdocs.yml)[project]modern (new) or classic (Material-compatible)lucide/ by default (also supports fontawesome, material, octicons, simple-icons)[project.markdown_extensions.<name>] TOML tables[project.plugins.<name>] TOML tableszensical new, zensical serve, zensical buildlocalhost:8000pymdownx.snippets replaces mkdocs-include-markdown for content reusemkdocs-macros has no direct substitute; Zensical is developing a module system