rust-lang/mdBook

mdBook is a command-line tool and Rust library for generating static HTML documentation from Markdown source files. It provides a modular architecture that handles Markdown parsing, pre-processing, and HTML rendering, while supporting custom preprocessors and alternative backends. The system includes built-in features like client-side search, syntax highlighting, and theme customization, all managed through a structured CLI and internal API.

This period focused on modernizing the project's infrastructure and developer experience. The CLI entry point and subcommands were reorganized into dedicated modules, and the continuous integration pipeline was migrated to GitHub Actions. Additionally, the project standardized development workflows, expanded the example suite for plugin and preprocessor development, and introduced a headless browser test suite for the GUI.

12 changes

The project underwent a significant architectural shift by extracting core components like the book model, markdown processing, and summary parsing into dedicated internal crates. Simultaneously, the HTML rendering pipeline was completely rewritten to support client-side search, dynamic navigation, and improved styling, while a new high-level driver API was introduced for programmatic usage.

24 changes

rust-lang/mdBook was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point the surveyor at a repository you know and see whether you agree with it.