#1145065 RFP: zensical -- A modern static site generator by the Material for MkDocs team

#1145065#5
Date:
2026-08-22 03:55:08 UTC
From:
To:
* Package name    : zensical
  Version         : 0.0.57
  Upstream Contact: https://github.com/zensical
* URL             : https://github.com/zensical/zensical
* License         : MIT
  Programming Lang: Rust
  Description     : A modern static site generator by the Material for MkDocs team

Zensical is a modern static site generator designed to simplify building
and maintaining project documentation. It's built by the creators of
Material for MkDocs and shares the same core design principles and
philosophy – batteries included, easy to use, with powerful
customization options

Write your documentation in Markdown and create a professional static
site for your Open Source or commercial project in minutes – searchable,
customizable, more than 60 languages, for all devices.
----

This is a rewrite of mkdocs (already in Debian) with parts of rust,
which aims to retain some backwards compatibility.

This is important because mkdocs 2.0 breaks a lot of plugins and old
design. A few of the reasoning is available upstream in:

https://mail.zensical.org/monthly/2026/02/
https://squidfunk.github.io/mkdocs-material/blog/2024/08/19/how-were-transforming-material-for-mkdocs/

It should be relatively similar to mkdocs, but a few features are still
missing, see:

https://zensical.org/compatibility/

Right now, the biggest missing features are:

- blog
- social cards
- tag lists
- revisioning

Third-party plugins are also not necessarily supported yet.

#1145065#10
Date:
2026-09-28 18:09:51 UTC
From:
To:
This is an RFP, so I'm not actively working on this, but I took a
look...

anarcat@angela:~/d/z/c/zensical> cargo debstatus --no-indent | grep 🔴 | sed 's/ v.*//' | sort -u | wc -l
56

i.e. there are *56* crates missing before we package this! those are:

 🔴 ast_node
 🔴 better_scoped_tls
 🔴 bytes-str
 🔴 cow-utils
 🔴 from_variant
 🔴 html5gum
 🔴 is-macro
 🔴 minijinja-contrib
 🔴 oxc_allocator
 🔴 oxc_ast
 🔴 oxc_ast_macros
 🔴 oxc_ast_visit
 🔴 oxc_cfg
 🔴 oxc_codegen
 🔴 oxc_data_structures
 🔴 oxc_diagnostics
 🔴 oxc_ecmascript
 🔴 oxc_estree
 🔴 oxc_index
 🔴 oxc-miette
 🔴 oxc-miette-derive
 🔴 oxc_parser
 🔴 oxc_regular_expression
 🔴 oxc_semantic
 🔴 oxc_sourcemap
 🔴 oxc_span
 🔴 oxc_syntax
 🔴 saphyr
 🔴 string_enum
 🔴 swc_atoms
 🔴 swc_common
 🔴 swc_css
 🔴 swc_css_ast
 🔴 swc_css_codegen
 🔴 swc_css_codegen_macros
 🔴 swc_css_minifier
 🔴 swc_css_parser
 🔴 swc_css_utils
 🔴 swc_css_visit
 🔴 swc_eq_ignore_macros
 🔴 swc_macros_common
 🔴 swc_visit
 🔴 unicode-id-start
 🔴 zensical
 🔴 zensical-serve
 🔴 zensical-watch
 🔴 zrx
 🔴 zrx-diagnostic
 🔴 zrx-executor
 🔴 zrx-graph
 🔴 zrx-id
 🔴 zrx-path
 🔴 zrx-scheduler
 🔴 zrx-storage
 🔴 zrx-store
 🔴 zrx-stream

The zensical* and zrx* crates are all part of the zensical project
itself, so that's 13/56 right there.

Then the other big chunk are the 19 crates of the OXC project
(https://oxc.rs/), the "The JavaScript Oxidation Compiler" by
"void0". Then the next big chunk (13 crates) is the SWC project
(https://swc.rs/) that is (another?) Javascript compilter (or a
"Rust-based platform for the Web"), for which there is a ITP (#991761).

That leaves about 11 individual crates to package as dependencies
outside of those big three projects.

I'll also note that zensical has expanded its feature set significantly
since I opened this issue, barely a month ago, when I said:

Since then, tag lists, blogs and RSS have been added, and they're
working on social cards next:

https://zensical.org/docs/compatibility/mkdocs/plugins/#compatibility-roadmap

For me the biggest feature missing right now is "revisionning",
specifically the "last modified at" field at the bottom of posts, but
it's not a blocker, considering how fast zensical is, and how badly
unmaintained mkdocs has become (#1149240), i've started switching my
projects.

a.