docs-mdbook-backend-dev

Build an MDBook backend by scaffolding a Rust plugin project, implementing a render function that processes RenderContext JSON input, and integrating it into book.toml. The Skill guides plugin structure, testing, and CLI entry point setup to generate custom output formats.

RenderContext is the JSON data structure MDBook passes to backend plugins containing book metadata, chapters, and configuration. Your renderer reads this JSON input and outputs the formatted book in your desired format.

Yes. The Skill provides a TDD workflow for backend plugins, enabling you to write tests that validate rendering logic before implementation and ensure your mdbook-<foo> renderer produces correct output consistently.

Yes. MDBook backend development requires Rust and Cargo for scaffolding cargo-based projects, building renderer plugins, and managing dependencies. The Skill assumes Rust toolchain compatibility and provides cargo project layouts.

Use Architecture Decision Records (ADRs) to document plugin design choices alongside your implementation. The Skill includes ADR-based documentation scaffolding and repository setup in the arustydev namespace to organize planning, data flow, and requirements.

Custom backends let you generate alternative output formats beyond HTML by implementing a Rust plugin that handles RenderContext. This approach solves the problem of lacking a customizable MDBook renderer for specialized formats or workflows.