A preprocessor for gathering checks in an mdBook and generating an index.
First, you need to install the preprocessor:
cargo install mdbook-checklist
Next, you need to add the preprocessor to your book.toml
:
[book]
authors = ["Me"]
multilingual = false
src = "src"
title = "The Book"
[preprocessor.checklist]
Finally, you can insert marks in your book chapters, according to the following
format: {{#check <name> | <description>}}
. For example
# Chapter 1
{{#check Note-1 | This is an important note}}
The mark will be replaced by the name solely (with an anchor to be linked from the index). Also, for this example, the following index will be generated:
Checklist
- Chapter 1:
- [ ] This is an important note (Note-1)
The title Checklist
of the generated index can be changed:
[preprocessor.checklist]
title = "A list of notes"
This library is published under the Open Licence 2.0.