Hacker News Reader

I'm personally a huge fan of `mdbook`, which seems to be the Rust equivalent of R's `bookdown`. I've switched out internal documentation over to it from `gitbook`.

https://github.com/rust-lang/mdBook

View on HN

+1 for mdBook, easy to install (as compared to say honkit [0], a gitbook fork, that requires npm). I've recently started using it to generate web version of my ebooks.

[0] https://github.com/honkit/honkit

mdBook is nice indeed but it still lacks a proper way to create PDFs. `bookdown` has a very smooth way to do that. The only thing I don't like is that is very R centric in terms of syntax for adding tables, graphs and whatnot. It's not pure markdown.

For things that will be online only mdBook is great.

I'm currently testing honkit which is a gitbook-cli fork and it seems OK.

> It's not pure markdown.

Be fair, it's not trying to be and not claiming to either.

Reply on news.ycombinator.com