Editor - 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

# Editor

In addition to providing runnable code playgrounds, mdBook optionally allows them to be editable. In order to enable editable code blocks, the following needs to be added to the book.toml:

    [output.html.playground]
    editable = true

After enabling editable code blocks, the `editable` attribute must be added to a code block to make it editable:

    ```rust,editable
    fn main() {
        let number = 5;
        print!("{}", number);
    }
    ```

The above will result in this editable playground:

    fn main() {
        let number = 5;
        print!("{}", number);
    }

Note the new `Undo Changes` button in the editable playgrounds.

## Customizing the Editor

By default, the editor is the Ace editor, but, if desired, the functionality may be overridden by providing a different folder:

    [output.html.playground]
    editable = true
    editor = "/path/to/editor"

Note that for the editor changes to function correctly, the `book.js` inside of the `theme` folder will need to be overridden as it has some couplings with the default Ace editor.