Curious if we've ever considered adding Markdown as a new MIME type that could be accepted directly by browsers (similar to text/plain). It could be nice to serve markdown without needing to even use a static-site generator (but still have the server reasonably render the doc, similar to a reader view).
Beaker Browser did this. The first problem about Markdown is: which variant do you support? The second problem is that people already treat it like a markup language with a mandatory post-processing step and will inevitably desire the level of control/precision that can only be achieved by making it more like HTML (or making liberal use of the <html> escape hatch).
I was under the same impression as well. I have been using https://docusaurus.io/ for some time now and I am very happy with it and I am pretty sure there are other tools out there as well.
What sold me on Znai was the integration of code snippets (straight from source files, mining them out of the code) and integration of diagramming from PlantUML, which is done in a way that is compatible with the format used in Gitlab, VSCode and other markdown renderers.
Markdown has turned into a truly amazing ecosystem.
It really looks great. I like your book section - I wonder why we read the same books. HN recommendations maybe; will look into the ones I didn't read. Thanks for sharing
good point. markdown as web content is widely used, but not whole web page. the project is a sample to use markdown as whole page by putting web element (header,ment,theme) in frontmater.