Static Libx presentation: examples show their complete code, including lines hidden in the original demo. Editing, code execution and MathJax rendering are provided by the original project; formula examples retain their original TeX notation here. The document text and expanded examples are retained. This is an unofficial Libx static edition. Original text and examples are preserved; translated pages are identified separately.

For developers

While mdbook is mainly used as a command line tool, you can also import the underlying libraries directly and use those to manage a book. It also has a fairly flexible plugin mechanism, allowing you to create your own custom tooling and consumers (often referred to as backends) if you need to do some analysis of the book or render it in a different format.

The For Developers chapters are here to show you the more advanced usage of mdbook.

The two main ways a developer can hook into the book’s build process is via,

The build process

The process of rendering a book project goes through several steps.

Load the book
- Parse the book.toml, falling back to the default Config if it doesn’t exist
- Load the book chapters into memory
- Discover which preprocessors/backends should be used
For each backend:
1. Run all the preprocessors.
2. Call the backend to render the processed result.

Using `mdbook` as a library

The mdbook binary is just a wrapper around the underlying mdBook crates, exposing their functionality as a command-line program. If you want to programmatically drive mdBook, you can use the [mdbook-driver] crate. This can be used to add your own functionality or tweak the build process.

The easiest way to find out how to use the mdbook-driver crate is by looking at the API Docs. The top level documentation explains how one would use the MDBook type to load and build a book, while the config module gives a good explanation on the configuration system.

For developers

The build process

Using mdbook as a library

Using `mdbook` as a library