News for hackers. Stuff that matters.

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

Re:MdBook – Create book from Markdown files. Like Gitbook bu... by msravi on Friday June 30, 2023 @04:09AM (#36531937)
So far, in this thread (in no particular order):

- [Jekyll](https://jekyllrb.com/)

- [Hugo Book](https://github.com/alex-shpak/hugo-book)

- [MdBook](https://rust-lang.github.io/mdBook/)

- [MkDocs](https://www.mkdocs.org/)

- [MkDocs Material](https://squidfunk.github.io/mkdocs-material/)

- [Antora](https://antora.org/)

- [Docusaurus](https://docusaurus.io/)

- [Nextra](https://nextra.site/)

- [Astro](https://astro.build/)

- [Starlight](https://starlight.astro.build/)

- [Clowncar](https://github.com/secretGeek/clowncar)

- [Keenwrite](https://github.com/DaveJarvis/keenwrite)

- [Quarto](https://quarto.org/)

- [Honkit](https://github.com/honkit/honkit)

[ Parent | on HN ]
Re:MdBook – Create book from Markdown files. Like Gitbook bu... by agoose77 on Friday June 30, 2023 @04:55AM (#36532191)
Also, https://jupyterbook.org/en/stable/

(nb) I collaborate on Jupyter Book

[ Parent | on HN ]
Re:MdBook – Create book from Markdown files. Like Gitbook bu... by elcritch on Friday June 30, 2023 @06:49AM (#36532762)
Nice list! I've also used [nimibook](https://pietroppeter.github.io/nimibook/).

Its a port of mdbook to Nim, but also extends it with the ability to generate interactive content as well using Nim's Javascript backend. Though I haven't tried this piece myself I like the idea of an all in one way to make interactive elements when desired: https://pietroppeter.github.io/nimib/interactivity.html

[ Parent | on HN ]
Re:MdBook – Create book from Markdown files. Like Gitbook bu... by d4rkp4ttern on Friday June 30, 2023 @07:44AM (#36533187)
HackMD is often my go-to to create a shareable (and collaboratively editable) markdown document that supports math notation.

https://hackmd.io/

[ Parent | on HN ]
Re:MdBook – Create book from Markdown files. Like Gitbook bu... by Cosi1125 on Friday June 30, 2023 @09:14AM (#36534266)
Also, Bookdown (https://bookdown.org/)
[ Parent | on HN ]
Re:MdBook – Create book from Markdown files. Like Gitbook bu... by throw_a_grenade on Friday June 30, 2023 @10:17AM (#36535360)
Plz add [Lektor](https://getlektor.com).

Happy user here.

[ Parent | on HN ]
Re:MdBook – Create book from Markdown files. Like Gitbook bu... by pyeri on Friday June 30, 2023 @10:20AM (#36535405)
Notable mention 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.
[ Parent | on HN ]
Re:MdBook – Create book from Markdown files. Like Gitbook bu... by jtbayly on Friday June 30, 2023 @10:35AM (#36535651)
I'd like to see a feature comparison table/site for these tools?

Which ones have...?

  - search built in
  - PDF output
  - ePub output
  - more than one theme
  - lots of other stuff
[ Parent | on HN ]
Re:MdBook – Create book from Markdown files. Like Gitbook bu... by skimdesk on Friday June 30, 2023 @12:48PM (#36538213)
Shameless plug for Doctave [0], which offers a solid way to combine markdown and OpenAPI specs into a documentation site.

It's a hosted SaaS, so it's technically not a static-site generator, but it's an alternative to the above.

[0]: https://www.doctave.com/

[ Parent | on HN ]
Re:MdBook – Create book from Markdown files. Like Gitbook bu... by geoffreymcgill on Saturday July 01, 2023 @02:56AM (#36547449)
How about Retype? https://retype.com
[ Parent | on HN ]