build - mdBook Documentation
Description: Create book from markdown files. Like Gitbook but implemented in Rust

## Keyboard shortcuts

Press `←` or `→` to navigate between chapters

Press `S` or `/` to search in the book

Press `?` to show this help

Press `Esc` to hide this help

# The build command

The build command is used to render your book:

    mdbook build

It will try to parse your `SUMMARY.md` file to understand the structure of your book and fetch the corresponding files. Note that this will also create files mentioned in `SUMMARY.md` which are not yet present.

The rendered output will maintain the same directory structure as the source for convenience. Large books will therefore remain structured when rendered.

#### Specify a directory

The `build` command can take a directory as an argument to use as the book’s root instead of the current working directory.

    mdbook build path/to/book

#### `--open`

When you use the `--open` (`-o`) flag, mdbook will open the rendered book in your default web browser after building it.

#### `--dest-dir`

The `--dest-dir` (`-d`) option allows you to change the output directory for the book. Relative paths are interpreted relative to the current directory. If not specified it will default to the value of the `build.build-dir` key in `book.toml`, or to `./book`.

Note: The build command copies all files (excluding files with `.md` extension) from the source directory into the build directory.