58

Third party plugins

Josh Rotenberg edited this page 2025-12-12 19:58:14 -08:00

Table of Contents

• Preprocessors
• Backends
• Other

mdBook can be extended with external commands. See the mdBook Guide for more information about extending mdBook. The following is a list of community-developed plugins for extending mdBook. If you are an author of a plugin, feel free to add it to this list!

Preprocessors

• mdbook-admonish: Adds support for Material Design admonishments, based on the mkdocs-material implementation.
• mdbook-alerts: A preprocessor that add GitHub Flavored Markdown's Alerts (similar to Obsidian's Callouts) syntax support
• mdbook-anchors-aweigh: Versatile "include" style preprocessor that can target code with Treesitter queries and template the included data.
• mdbook-blocks: Add beautiful Bootstrap components to your books, also supports a live viewer for vscode to write and preview your books contents in real-time!
• mdbook-classy: Adds support for kramdown-style CSS class annotations to paragraphs.
• mdbook-cmdrun: A preprocessor that runs arbitrary commands and replace the stdout of these commands inside the markdown file.
• mdbook-codeblocks: A preprocessor to prepend customizable vignette to code blocks.
• mdbook-djot: A preprocessor to parse Djot (.dj) files into html.
• mdbook-embedify: A preprocessor that allows you to embed apps to your book, like youtube, codepen, giscus and many other apps.
• mdbook-footnote: Adds support for auto-numbered footnotes.
• mdbook-force-relative-links: A preprocessor to transform absolute links into relative ones
• mdbook-github-authors: A preprocessor for mdbook that creates chapter-level contributor sections featuring authors' GitHub profiles.
• mdbook-gitinfo: A preprocessor that injects Git metadata (e.g., commit hash, date, tag) into your rendered book's footer. This is useful for displaying build provenance or version information.
• mdbook-graphviz: Renders graphs using Graphviz
• mdbook-haskell: Source code includes for Haskell.
• mdbook-hide: A preprocessor for mdbook that adds support for hidden chapters.
• mdbook-i18n-helpers: Translation support using a Gettext-based workflow.
• mdbook-i18n: Enhance multi-lang version.
• mdbook-image-size: A preprocessor that supports image size syntax.
• mdbook-include-filter: Allows you to include rows from other pages, filtering by tags and mentions; transforms mdbook into a task-tracking tool.
• mdbook-indexing: Adds support for index generation.
• mdbook-inline-highlighting: mdBook preprocessor that enables support for inline highlighting.
• mdbook-journal: Workflow tool that can generate templated documentation, notes, measurements...
• mdbook-katex: A preprocessor rendering LaTex equations to HTML.
• mdbook-keeper: Better testing support for mdbook -- add third party crates and do testing during build.
• mdbook-lint: A fast, configurable markdown linter with 83 rules (55 standard, 18 mdBook-specific, 10 content). Works as both CLI and preprocessor. Supports auto-fix for 41 rules.
• mdbook-mathpunc: A preprocessor that prevents line breaks between inline math blocks and punctuation marks when using mdbook-katex.
• mdbook-mermaid: Uses mermaid.js to create diagrams from text.
• mdbook-morsels: Alternative client-side search solution.
• mdbook-numeq: A preprocessor to automatically number centered equations and later create a link to these equations for a "LaTeX" type experience.
• mdbook-numthm: A preprocessor to automatically number theorems, lemmas, etc.
• mdbook-pagetoc: Adds sidebar table of contents. Rust wrapper for mdBook-pagetoc.
• mdbook-pikchr: Renders Pikchr code blocks as SVG images in your book.
• mdbook-plantuml: Renders PlantUML code blocks as images in your book.
• mdbook-private: A preprocessor that allows for private sections to be defined and hidden or kept.
• mdbook-reading-time: A preprocessor that calculates word count and reading time.
• mdbook-repl: A preprocessor that allows you to execute code in your markdown book without any server. Python, Typescript, Javascript etc.
• mdbook-selfpath: A preprocessor that inserts the source file path into your book's page content.
• mdbook-shiftinclude: A preprocessor that allows included files to be shifted left or right.
• mdbook-svgbob: Turns ASCII diagrams into SVG.
• mdbook-template: A preprocessor that allows the re-usability of template files with dynamic arguments.
• mdbook-tera: A Tera preprocessor that allows template-based rendering
• mdbook-toc: Adds inline Table of Contents.
• mdbook-typst-math: Uses Typst to render math expressions.
• mdbook-qr: Injects QR codes via fast_qr
• mdbook-webinclude: A preprocessor that includes content over HTTP
• mdbook-yapp: A preprocessor for mdbook that simply replaces text in chapters.
• mdbook-yml-header: Clean up the yml-header in top of files from ie. obsidian

Backends

• mdbook-asciidoc: Experimental AsciiDoc generator.
• mdbook-asciidoc: Yet another AsciiDoc generator.
• mdbook-epub: An experimental EPUB generator.
• mdbook-i18n-helpers: Extract translatable text to a Gettext .po file.
• mdbook-linkcheck: Checks for broken links.
• mdbook-man: Generates man pages.
• mdbook-pandoc: Generate PDFs and more with Pandoc.
• mdbook-pdf: Generate PDF, based on headless_chrome and Chrome DevTools Protocol.
• mdbook-test: A program to run the book's contents through rust-skeptic to verify everything compiles and runs correctly (similar to rustdoc --test)
• mdbook-texi: A backend plugin to convert to Texinfo format used in Emacs and Info
• mdbook-typst: Generate PDFs, PNGs, SVGs, and raw Typst markup.
• mdbook-tiny: Generate minimal html with page navigation and inline CSS.

Other

• mdBook-pagetoc: Adds sidebar table of contents.
• mdbook-whichlang: Powerful Code Blocks for mdBook