"But it's surprisingly challenging to publish books on the web in nice, cohesive, tight, easy-to-navigate HTML format." Quarto is one great option for doing that today. Bonus: it can also generate EPUBs and PDFs, all from one set of source files. https://quarto.org/ It's free and open source. https://github.com/quarto-dev/quarto-cli https://jjallaire.github.io/hopr/. - Source: Hacker News / 24 days ago

I've used Quarto[1] to build a personal blog and it has been really easy and straightforward. Especially if you want to run some code alongside the post (like Python, R, or Julia). As far as I know, you can also use it to write books and presentations. [1]: https://quarto.org/. - Source: Hacker News / 30 days ago

> Interactive examples have been added to the documentation, allowing users to run the examples locally on embedded Jupyterlite notebooks in their browser. This might sound strange, but to me this is the most exciting thing listed in the update document. I've been looking for ways to include _interactive_ Python scripts on static webpages (such as those made using Jupyter Book [1] or Quarto [1]. Up to now the only... - Source: Hacker News / 2 months ago

Deckset was the OG in this space, which I used a decade (!) ago in college. Looks like they moved off the Mac App Store, and are bringing out an iOS app now: https://www.deckset.com Now I much prefer something like https://quarto.org with dataviz. - Source: Hacker News / 4 months ago

To mirror another comment: I really like the concept and will give it a try. As an alternative, I want to suggest [Quarto](https://quarto.org) - somewhat similar, easy to use, one might even call it "basic" (I mean that in a good way!) 7/5 ^^. - Source: Hacker News / 4 months ago

Markup language: Markup language is used to write documents in a way that distinguishes them from plain text. Most SSGs utilize lightweight markup languages, such as Markdown. However, alternatives like AsciiDoc, Textile, and ReStructuredText are also used. These lightweight languages simplify content creation and are converted into HTML during the site generation process. - Source: dev.to / 8 months ago

Uses Sphinx, reStructuredText And the sphinx-rtd-theme for writing, building And rendering the documentation. Source: 9 months ago

If we're dreaming, ReStructed Text support. Source: about 1 year ago

You can always switch to rst¹ and sphinx² to produce html/pdf came join the dark side, we have tables³ :) 1. https://docutils.sourceforge.io/rst.html. - Source: Hacker News / over 1 year ago

ReStrutucturedText is still useful to look at for inspiration here. It had the concepts of extensible metadata ("field lists"), spans ("interpreted text"), and blocks ("directives"). Including things like applying metadata to spans (using essentially Footnotes to provide field lists to interpreted text sections, like but better than Markdown's reference style for hyperlinks which almost no one uses but were much... - Source: Hacker News / almost 2 years ago