MdBook – Create book from Markdown files. Like Gitbook but implemented in Rust

Re:MdBook – Create book from Markdown files. Like Gitbook bu... by dcchambers on Thursday June 29, 2023 @11:20PM (#36530139)

I am a long time Jekyll user and I still think it's a great tool for blogs, but by far the best SSG for documentation websites I have found is Docusaurus. (https://docusaurus.io/)

I resisted trying it for the longest time because I didn't want a JavaScript based tool, but I am glad I caved. It's so easy to get started, crazy fast, and the sites are absolutely beautiful out of the box yet easy to customize. The mdx support is awesome too.

[ Parent | on HN ]

Re:MdBook – Create book from Markdown files. Like Gitbook bu... by klodolph on Thursday June 29, 2023 @11:30PM (#36530204)

Somehow I missed Docusaurus when I surveyed documentation generators—it looks very good!

I can understand the desire to want something not written in JavaScript, and I certainly have my own language prejudices, but when I surveyed static site generators, language choice was all over the map. Like, I was willing to wrangle Ruby installations and gems to get Jekyll working, something I have nearly no experience with.

[ Parent | on HN ]

Re:MdBook – Create book from Markdown files. Like Gitbook bu... by KRAKRISMOTT on Friday June 30, 2023 @02:19AM (#36531192)

Also

https://nextra.site/

[ Parent | on HN ]

Re:MdBook – Create book from Markdown files. Like Gitbook bu... by slorber on Friday June 30, 2023 @02:52PM (#36540273)

Docusaurus maintainer here, happy to read your feedback ;)

[ Parent | on HN ]