#mdbook #generate #summary

app mdbook-generate-summary

A tool to automatically generate mdBook SUMMARY.md files

2 unstable releases

0.2.0 Jun 14, 2019
0.1.0 Mar 27, 2019

#7 in #summary

36 downloads per month

MIT license

266 lines


This is a CLI tool to generate the SUMMARY.md page for an mdBook repository.

This is a tool I wrote because I'm abusing mdBook to act as a knowledge repository, and not as an actual book. I wanted to streamline the process of adding pages as much as possible, and not have to worry too much about maintaining that SUMMARY.md.

This does, however, make a few assumptions on the layout of your book:

Each subpage has an accompanying README.md.

E.G. Your book will always have the following directory tree under the src/:


That is, you'll never have a directory with a .md file in it, that doesn't ALSO have a README.md file.

If you do, the program won't detect that edge case, and it won't do the right thing.


~65K SLoC