A couple days ago we released v0.1.0 of mdbook, a Rust tool for generating documents from markdown files on disk. Despite the low version number this is actually our 29th release, bringing with it a lot of new features and improvements. If you've ever read The Book or Rust By Example then you've actually experienced mdbook first hand!

Significant changes include:

• Improved accessibility

• An updated configuration format

• The ability to create your own backends and tooling for working with books

Special thanks goes to @JaimeValdemoros, a first time contributor to mdbook who responded to a mentoring opportunity posted on Reddit! He helped clean up a lot of the code internally by formalising the concept of preprocessors and paved the way for future improvements, doing an awesome job in the process :grinning:

Three alternate backends already exist:

Feel free to try out the new version of mdbook and let us know what you think.

Even if you are not familiar with the mdbook project you are very familiar with its output. Almost every Rust-related open source book uses it.

In the last couple of weeks I started to use it and then started to contribute to the project. One thing I needed was to be able to see how others use mdbook. What plugins they use. What configuration options they set etc. That's how the Public mdBooks project was started.

It lists 146 public mdBooks I found and provides some analysis about them.

I believe it can be useful to anyone who is interested to use mdbook and some of its plugins to get ideas from other books.

It can be also nice for the authors of the various mdbook plugins to see who is using their plugins and how?

So, please check out the Public mdBooks and if you know about any other mdbook which is not listed yet, please, comment here, open an issue or a pull-request on the repository.