News for hackers. Stuff that matters.

A comment on Zensical – A modern static site generator built by the Material for MkDocs team.

Re:Zensical – A modern static site generator built by the Ma... by xixixao on Sunday November 09, 2025 @02:31PM (#45868400)
Documentation tooling for Python (especially reference docs) is… abysmal. Sphinx is the king, with no markdown support. Pdoc would be nice, it the authors didn’t reject reasonable additions, leading to forks. And mkdocs is not simple to setup. If you’re building a company for this, please fix this.
[ Parent | on HN ]
Re:Zensical – A modern static site generator built by the Ma... by WhyNotHugo on Sunday November 09, 2025 @04:09PM (#45869199)
AFAIK, Sphinx does support markdown… the issue with markdown is that it doesn’t support macros like RST, so there’s a huge amount of functionality that can’t translate well to it.
[ Parent | on HN ]
Re:Zensical – A modern static site generator built by the Ma... by squidfunk on Sunday November 09, 2025 @02:37PM (#45868447)
We'll do our best! The author of mkdocstrings[1] (the leading API reference docs solution in the MkDocs space) is part of our team, so we're aiming to bring much more powerful API reference docs support to Zensical.

[1]: mkdocstrings.github.io

[ Parent | on HN ]
Re:Zensical – A modern static site generator built by the Ma... by kapilvt on Sunday November 09, 2025 @02:39PM (#45868473)
Sphinx does have markdown support fwiw
[ Parent | on HN ]