mdbook-numbering

A mdBook preprocessor that adds numbering.

• Adds numbers prior to chapter titles.
• Configurable numbering formats (e.g., "1.", "1.1.", "I.", "A.", etc.).
• Adds numbers to lines in code blocks.

Configuration

Add the following to your book.toml:

[preprocessor.numbering]

Then configure as needed (see [Configuration]), for example:

[preprocessor.numbering]
# Configuration for heading numbering
heading = {
  enable          = true,
  numbering_style = "consecutive", # "consecutive" or "top"
}
# Configuration for code block line numbering
code = {
  enable          = true,
}

Note

• Using highlightjs-line-numbers.js to add line numbers to code blocks in the rendered HTML. The license of highlightjs-line-numbers.js is MIT License, and is copied to src/highlightjs/LICENSE.

  Some modifications have been made to the original code to fit into this project.