-
Interesting enough there seems to be an open PR for that: https://github.com/rust-lang/mdBook/pull/1918
-
SaaSHub
SaaSHub - Software Alternatives and Reviews. SaaSHub helps you find the best software and product alternatives
-
I haven't seen the newcomer Starlight[1] being mentioned, so just throwing that out there as well. It's by the wonderful folks who created Astro[2] and my own limited usage of it has been great!
[1]: https://starlight.astro.build/
[2]: https://astro.build/
-
I use hugo with the book theme (https://github.com/alex-shpak/hugo-book). It takes a bit of getting used to (if you're not familiar with hugo) but after that it's pretty good with all the flexibility that hugo provides for shortcodes, etc. The katex support is good (looks like mdBook uses mathjax) and deploying just becomes a push/rsync.
-
I am a long time Jekyll user and I still thing 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.
-
Wow, what is up with the material mkdocs theme (https://squidfunk.github.io/mkdocs-material/)? That's an extremely spiffy landing page, especially given that it's for a theme designed for a totally separate piece of software.
-
nextra
Simple, powerful and flexible site generation framework with everything you love from Next.js.
-
KeenWrite
Discontinued Free, open-source, cross-platform desktop Markdown text editor with live preview, string interpolation, and math.
I wrote KeenWrite, a free and open-source cross-platform tool, to create Markdown-based books. KeenWrite calls out to ConTeXt to typeset the documents and uses my KeenType fork for typesetting math while in preview mode. KeenWrite can generate PDF files from the command-line.
* https://github.com/DaveJarvis/keenwrite
For example:
java -jar keenwrite.jar \
-
-
Since I see a few people in these comments mourning the general dive that gitbook has taken over the last few years, you might like this, an actively-maintained fork of gitbook as it was before it got bad:
https://github.com/honkit/honkit
-
Md book is great! We created a Nim version to support content written with nimib (a framework to publish html pages with Nim code and its results) and it has been very useful! https://pietroppeter.github.io/nimibook/index.html
As people are sharing other SSG (I think material for MkDocs is the absolute best for documentation sites), let me share a relatively unknown one that I find very interesting: https://github.com/dmulholl/ark
I have as next project to try and port this ark to Nim/nimib (and ideally nimibook should be refactored to use it).
-
-
-
-
-
Found: https://github.com/zoni/obsidian-export but hope this can be part of a single solution.
-
obsidian-enveloppe
Enveloppe helps you to publish your notes on a GitHub repository from your Obsidian Vault, for free!
MkDocs with Obsidian Mkdocs? https://obsidian-publisher.netlify.app
-
Notable mentions to [Sphinx](https://www.sphinx-doc.org/). It's workflow is more tuned to the "book" format rather than the blog, forum or thread format.
-
elegant-cli
✨ Build SEO-friendly websites, super fast full-stack web applications, and much more with Elegant. 💜 Built with Next.js, TipTap, Tailwind CSS, and more.
I have used a number of different solutions over the years for simple documentation. Started with Wordpress, ended up on Docusaurus.
Docusaurus is an amazing tool for startups, but it started to show its weaknesses as tried to scale it.
Our project requirements needed something more, so I ended up forking Docusaurus and started working on my own solution.
Check it out, I’d love to hear what everyone thinks! :)
https://github.com/elegantframework/elegant-cli
https://www.elegantframework.com/docs/installation
-
retype
Retype is an ✨ ultra-high-performance✨ static site generator that builds a website based on simple text files.