{"slug": "zensical", "name": "Zensical", "category": "notes", "category_name": "Notes and knowledge", "description": "", "recommenders": 4, "commenters": 11, "warners": 0, "score": 4.915, "rising": -1.31, "first": "2025-11-09", "latest": "2026-05-12", "why": "Zensical has been a solid replacement for us so far.", "why_is_quote": true, "has_verdict": false, "sentiment": {"recommend": 4, "neutral": 4, "compare": 3, "warn": 0}, "spark": [1, 0, 1, 0, 0, 0, 2, 0, 0, 0, 0, 0], "listed": true, "loved": [], "caveat": "", "short_quote": "Zensical has been a solid replacement for us so far.", "kind": "", "icon": true, "domain": "zensical.org", "github_repo": null, "official_url": "https://zensical.org/", "pricing": "", "aliases": ["Zensical"], "verdict": null, "praise": [{"label": "", "summary": "", "quotes": [{"id": 769731984, "item_id": 48108249, "url": "https://news.ycombinator.com/item?id=48108249", "by": "mackatsol", "date": "2026-05-12", "stance": "recommend", "quote": "I have no idea how the search works though!", "excerpt": "https://zensical.org/ I have no idea how the search works though!", "context": "", "use_case": "docs site generator", "switched_from": "", "story": "Ask HN: Best static site generator for a docs site in 2026?"}, {"id": 768612352, "item_id": 48038272, "url": "https://news.ycombinator.com/item?id=48038272", "by": "athorax", "date": "2026-05-06", "stance": "recommend", "quote": "Zensical has been a solid replacement for us so far.", "excerpt": "Zensical has been a solid replacement for us so far. In general everything \"just works\" out of the box and is way quicker to build/reload. It is still in fairly early stages, but is actively being worked on https://zensical.org/spark/proposals/zap-005-navigation-authoring-experience/ I hope they are able to monetize in a way the keeps the core project open while making it a sustainable venture going forward.", "context": "", "use_case": "", "switched_from": "MkDocs", "story": "Our Continuation of MkDocs"}, {"id": 745964432, "item_id": 46622777, "url": "https://news.ycombinator.com/item?id=46622777", "by": "rileymichael", "date": "2026-01-14", "stance": "recommend", "quote": "it solves this specific requirement by autogenerating the navigation based on file structure.", "excerpt": "> MkDocs: Works great with JS disabled, however the table of contents needs to be maintained via mkdocs.yml, which can be quite tedious. note that the mkdocs-material folks are now working on https://zensical.org/ which is in rust and _much_ faster. it solves this specific requirement by autogenerating the navigation based on file structure. it's still early / under active development, but i recently rebuilt our tech", "context": "", "use_case": "Documentation site generation", "switched_from": "", "story": "You Don't Need Mintlify"}, {"id": 733947714, "item_id": 45871732, "url": "https://news.ycombinator.com/item?id=45871732", "by": "parser_error", "date": "2025-11-09", "stance": "recommend", "quote": "This looks very interesting", "excerpt": "This looks very interesting, I'm using mkdocs+material for one site (and it's great) but trying to find a good solution for more complex docs. Is there anything planned like 11ty's data files[1]? For example, I can pass it a JSON file, or a TOML file, and have it generate one HTML page per document in that file using their pagination system in a hacky way, and add those pages to collections for grouping in navigation", "context": "", "use_case": "", "switched_from": "", "story": "Zensical \u2013 A modern static site generator built by the Material for MkDocs team"}]}], "caveats": [], "who": [], "tags": [], "use_cases": ["documentation site generator", "docs site generator", "documentation site generation", "documentation site"], "compared": [{"slug": "material-for-mkdocs", "name": "Material for MkDocs", "co": 7, "switched_from": 1, "switched_to": 0}, {"slug": "mkdocs", "name": "MkDocs", "co": 5, "switched_from": 1, "switched_to": 0}], "makers": [{"id": 733983296, "item_id": 45873956, "url": "https://news.ycombinator.com/item?id=45873956", "by": "squidfunk", "date": "2025-11-10", "stance": "recommend", "quote": "Zensical team here.", "excerpt": "Zensical team here. Yes, there are very good reasons for that change. First and foremost, with MkDocs using YAML, and Material for MkDocs being the main entrypoint for many of our users, we got a lot of issues with users having trouble just getting the indentation of YAML right. Secondly, and this is even more problematic: Python Markdown allows the use of custom YAML tags[1], which translate to function references d", "context": "", "use_case": "", "switched_from": "", "story": "Zensical \u2013 A modern static site generator built by the Material for MkDocs team"}, {"id": 733982272, "item_id": 45873892, "url": "https://news.ycombinator.com/item?id=45873892", "by": "squidfunk", "date": "2025-11-10", "stance": "recommend", "quote": "It's perfectly usable", "excerpt": "Zensical team here. It's perfectly usable \u2013 we're of course building our own docs with it and the first users have already switched \u2013 but you have to have an eye on compatibility. Whether you can switch right now largely depends on which plugins you're using from the MkDocs ecosystem. We have an entire section on compatibility.[1] If Material for MkDocs ticks off all or most of the boxes, you can definitely start usi", "context": "", "use_case": "Documentation sites", "switched_from": "", "story": "Zensical \u2013 A modern static site generator built by the Material for MkDocs team"}, {"id": 733910016, "item_id": 45869376, "url": "https://news.ycombinator.com/item?id=45869376", "by": "squidfunk", "date": "2025-11-09", "stance": "neutral", "quote": "The differential runtime is called ZRX[1], which forms the foundation of Zensical.", "excerpt": "Excellent question. We're not using differential dataflow (DD), but are rolling our own differential runtime. It's basically functions stitched together with operators, heavily inspired by DD and RxJS, and is optimized for performance and ease of use. The decision to go from scratch allows us to provide something that, IMHO, is much simpler to work with than DD and Rx, as our goal is to allow an ecosystem to evolve, ", "context": "", "use_case": "Static site generator", "switched_from": "", "story": "Zensical \u2013 A modern static site generator built by the Material for MkDocs team"}, {"id": 733878576, "item_id": 45867411, "url": "https://news.ycombinator.com/item?id=45867411", "by": "squidfunk", "date": "2025-11-09", "stance": "recommend", "quote": "Most users favor the new look over the old one.", "excerpt": "Creator of Zensical here! As always, it's a matter of taste. We felt the original look was a little date. You can use the classic Material for MkDocs look with Zensical by adding a single line of configuration[1]. This works because the HTML is exactly the same right now. Most users favor the new look over the old one. [1]: https://zensical.org/docs/setup/basics/#theme-variant", "context": "Creator of Zensical", "use_case": "", "switched_from": "", "story": "Zensical \u2013 A modern static site generator built by the Material for MkDocs team"}], "threads": [{"url": "https://news.ycombinator.com/item?id=45865189", "title": "Zensical \u2013 A modern static site generator built by the Material for MkDocs team", "mentions": 9}, {"url": "https://news.ycombinator.com/item?id=47482185", "title": "The Slow Collapse of MkDocs", "mentions": 3}, {"url": "https://news.ycombinator.com/item?id=48092561", "title": "Ask HN: Best static site generator for a docs site in 2026?", "mentions": 1}, {"url": "https://news.ycombinator.com/item?id=48037261", "title": "Our Continuation of MkDocs", "mentions": 1}, {"url": "https://news.ycombinator.com/item?id=46596823", "title": "You Don't Need Mintlify", "mentions": 1}], "sentiment_by_month": {"2025-11": {"compare": 2, "neutral": 2, "recommend": 1}, "2025-12": {}, "2026-01": {"recommend": 1}, "2026-02": {}, "2026-03": {"neutral": 2, "compare": 1}, "2026-04": {}, "2026-05": {"recommend": 2}, "2026-06": {}, "2026-07": {}, "2026-08": {}, "2026-09": {}, "2026-10": {}}, "quotes": [{"id": 769731984, "item_id": 48108249, "url": "https://news.ycombinator.com/item?id=48108249", "by": "mackatsol", "date": "2026-05-12", "stance": "recommend", "quote": "I have no idea how the search works though!", "excerpt": "https://zensical.org/ I have no idea how the search works though!", "context": "", "use_case": "docs site generator", "switched_from": "", "story": "Ask HN: Best static site generator for a docs site in 2026?"}, {"id": 768612352, "item_id": 48038272, "url": "https://news.ycombinator.com/item?id=48038272", "by": "athorax", "date": "2026-05-06", "stance": "recommend", "quote": "Zensical has been a solid replacement for us so far.", "excerpt": "Zensical has been a solid replacement for us so far. In general everything \"just works\" out of the box and is way quicker to build/reload. It is still in fairly early stages, but is actively being worked on https://zensical.org/spark/proposals/zap-005-navigation-authoring-experience/ I hope they are able to monetize in a way the keeps the core project open while making it a sustainable venture going forward.", "context": "", "use_case": "", "switched_from": "MkDocs", "story": "Our Continuation of MkDocs"}, {"id": 760298642, "item_id": 47518665, "url": "https://news.ycombinator.com/item?id=47518665", "by": "digital_voodoo", "date": "2026-03-25", "stance": "compare", "quote": "The comparison the latter makes with Zensical", "excerpt": "As a non-technical person (not a dev, not a SWE, just a curious and selftaught tinkerer), I only want my _local_ markdown files to render as a beautiful - or at least, clean - webpage, to ease reading and sharing. No Github involved, no contorsionism needed. Just local md files. It should not be that complicated, at least that's what I felt. Those were the only requirements that made me settle with Material MkDocs, a", "context": "", "use_case": "", "switched_from": "", "story": "The Slow Collapse of MkDocs"}, {"id": 760243648, "item_id": 47515228, "url": "https://news.ycombinator.com/item?id=47515228", "by": "karel-3d", "date": "2026-03-25", "stance": "neutral", "quote": "squidfunk that just rewrote the entire thing as Zensical.", "excerpt": "squidfunk that just rewrote the entire thing as Zensical. https://github.com/zensical/zensical", "context": "", "use_case": "", "switched_from": "", "story": "The Slow Collapse of MkDocs"}, {"id": 759832832, "item_id": 47489552, "url": "https://news.ycombinator.com/item?id=47489552", "by": "josiahpeters", "date": "2026-03-23", "stance": "neutral", "quote": "We\u2019re going to definitely give them a shot.", "excerpt": "Of course, we just adopted Material for MK Docs about 12 months ago. I\u2019ve been looking at Zensical https://zensical.org/ as a replacement, but I couldn\u2019t fully reason why they went off and did their own thing. I wasn\u2019t sure if it was a money grab or what their motivation was. This article provided the context I needed to understand the why. We\u2019re going to definitely give them a shot.", "context": "", "use_case": "documentation site generator", "switched_from": "Material for MkDocs", "story": "The Slow Collapse of MkDocs"}, {"id": 745964432, "item_id": 46622777, "url": "https://news.ycombinator.com/item?id=46622777", "by": "rileymichael", "date": "2026-01-14", "stance": "recommend", "quote": "it solves this specific requirement by autogenerating the navigation based on file structure.", "excerpt": "> MkDocs: Works great with JS disabled, however the table of contents needs to be maintained via mkdocs.yml, which can be quite tedious. note that the mkdocs-material folks are now working on https://zensical.org/ which is in rust and _much_ faster. it solves this specific requirement by autogenerating the navigation based on file structure. it's still early / under active development, but i recently rebuilt our tech", "context": "", "use_case": "Documentation site generation", "switched_from": "", "story": "You Don't Need Mintlify"}, {"id": 733947714, "item_id": 45871732, "url": "https://news.ycombinator.com/item?id=45871732", "by": "parser_error", "date": "2025-11-09", "stance": "recommend", "quote": "This looks very interesting", "excerpt": "This looks very interesting, I'm using mkdocs+material for one site (and it's great) but trying to find a good solution for more complex docs. Is there anything planned like 11ty's data files[1]? For example, I can pass it a JSON file, or a TOML file, and have it generate one HTML page per document in that file using their pagination system in a hacky way, and add those pages to collections for grouping in navigation", "context": "", "use_case": "", "switched_from": "", "story": "Zensical \u2013 A modern static site generator built by the Material for MkDocs team"}, {"id": 733931872, "item_id": 45870742, "url": "https://news.ycombinator.com/item?id=45870742", "by": "perpil", "date": "2025-11-09", "stance": "neutral", "quote": "It doesn't support loading content from a database that I'm aware of", "excerpt": "Its predecessor (mkdocs material) supported blogs via a plugin and rss feeds via a mkdocs plugin (https://guts.github.io/mkdocs-rss-plugin/). I don't believe it supports blogs yet according to this: https://zensical.org/compatibility/#phased-transition-strategy but will in the next phase when it supports plugins. It doesn't support loading content from a database that I'm aware of, it uses markdown files on disk as i", "context": "", "use_case": "Documentation site generator", "switched_from": "", "story": "Zensical \u2013 A modern static site generator built by the Material for MkDocs team"}, {"id": 733908946, "item_id": 45869309, "url": "https://news.ycombinator.com/item?id=45869309", "by": "runningmike", "date": "2025-11-09", "stance": "compare", "quote": "Like to see a real comparison with Zensical", "excerpt": "The new modern static site generator and best for now seems to be Jupyter Book 2 - https://jupyterbook.org/stable/ Launched last week and build upon MyST engine. Makes Shphinx obsolete. Like to see a real comparison with Zensical.", "context": "", "use_case": "", "switched_from": "", "story": "Zensical \u2013 A modern static site generator built by the Material for MkDocs team"}, {"id": 733896784, "item_id": 45868549, "url": "https://news.ycombinator.com/item?id=45868549", "by": "tamimio", "date": "2025-11-09", "stance": "neutral", "quote": "It looks interesting, might give it a try.", "excerpt": "It looks interesting, might give it a try. I currently use Zola and it\u2019s been great so far.", "context": "", "use_case": "", "switched_from": "", "story": "Zensical \u2013 A modern static site generator built by the Material for MkDocs team"}, {"id": 733869713, "item_id": 45866857, "url": "https://news.ycombinator.com/item?id=45866857", "by": "portaouflop", "date": "2025-11-09", "stance": "compare", "quote": "any reason I should switch to this or does it make more sense if you have a greenfield use case?", "excerpt": "I use docusaurus and am happy - any reason I should switch to this or does it make more sense if you have a greenfield use case? I don\u2019t really care how long it takes to build as long as it\u2019s not minutes. Also don\u2019t care about \u201cmodern\u201d look whatever that means really. And I have lots of custom components that (I assume?) would be hard to migrate", "context": "", "use_case": "documentation site", "switched_from": "", "story": "Zensical \u2013 A modern static site generator built by the Material for MkDocs team"}]}