docs-mdbook-preprocessor-dev

Develop an mdbook preprocessor by creating a Rust project using the mdbook-preprocessor interface, implementing input/output schema handling, and integrating it into book.toml. The Skill covers skeleton setup, TDD workflow, and complete plugin implementation from planning through repository creation.

Use an mdbook preprocessor plugin to intercept and modify book content at build time. This Skill guides you through planning plugin functionality, writing tests, documenting data flows and schemas, and implementing the Rust processor using mdbook's preprocessing interface.

Yes, this Skill assumes Rust knowledge and teaches mdbook-preprocessor development using Rust and the mdbook crate. It covers test-driven development, Cargo.toml configuration, and the mdbook-preprocessor interface, progressing from planning through implementation.

Build test scaffolding alongside your preprocessor implementation, following TDD practices to validate input/output transformations. This Skill includes guidance on writing tests, documenting behavior with ADRs and data-flow diagrams, and validating schema compliance before deployment.

Preprocessors require Architecture Decision Records (ADRs), data-flow diagrams, input/output schemas, examples, and user stories. This Skill covers documenting plugin functionality, dependencies, and integration points so users understand what the preprocessor transforms and why.

Yes, this Skill includes discovery of existing mdbook plugins as a learning step. You'll explore community preprocessors to understand patterns, then build your own custom plugin with GitHub repository scaffolding under your account.