#chapter #mdbook #hidden #preprocessor #hide #markdown

bin+lib mdbook-hide

A preprocessor for mdbook that adds support for hidden chapters

4 releases (breaking)

0.4.0 Sep 30, 2023
0.3.0 Aug 8, 2023
0.2.0 Jul 18, 2023
0.1.0 Jul 11, 2023

#1632 in Text processing

Download history 93/week @ 2024-07-22 70/week @ 2024-07-29 126/week @ 2024-08-05 62/week @ 2024-08-26 110/week @ 2024-09-02 16/week @ 2024-09-09 49/week @ 2024-09-16 120/week @ 2024-09-23 48/week @ 2024-10-07 202/week @ 2024-10-14 59/week @ 2024-10-21 70/week @ 2024-10-28 121/week @ 2024-11-04

454 downloads per month

BSD-3-Clause

17KB
129 lines

mdbook-hide

A preprocessor for mdbook that adds support for hidden chapters. The hidden chapters can be marked by adding a special Markdown comment. Based on the config, hidden chapters can be added or removed in the build.

Installation

Currently, this preprocessor is only available as a crate. In future, I'll add the binary releases as well. To install, run the command:

cargo install mdbook-hide

Usage

To use the preprocessor in your mdbook, add the following section in the book.toml. If the hide is set to true, then the hidden chapters will be removed.

[preprocessor.hide]
hide = true

To mark a chapter as hidden, add this special Comment anywhere in the Markdown file. It is better to have it at the top of the file for clarity.

<!--hidden-->

Dependencies

~12–23MB
~341K SLoC