mdBook/book-example/src/cli/test.md

The test command

When writing a book, you sometimes need to automate some tests. For example, The Rust Programming Book uses a lot of code examples that could get outdated. Therefore it is very important for them to be able to automatically test these code examples.

mdBook supports a test command that will run all available tests in mdBook. At the moment, only one test is available: "Test Rust code examples using Rustdoc", but I hope this will be expanded in the future to include more tests like:

• checking for broken links
• checking for unused files
• ...

In the future I would like the user to be able to enable / disable test from the book.toml configuration file and support custom tests.

How to use it:

$ mdbook test
[*]: Testing file: "/mdBook/book-example/src/README.md”