Buy Sergey a 🍜 Sergey (onixpro) is the original creator of this plugin. Repo can be found here.

This plugin enables you to embed interactive drawio diagrams in your documentation. Simply add your files like you would any other image:

![](my-diagram.drawio)

Additionally this plugin supports multi page diagrams by using the alt text to select the pages by name:

![Page-2](my-diagram.drawio)
![my-custom-page-name](my-diagram.drawio)

Install plugin using pip:

pip install mkdocs-drawio

Add the plugin to your mkdocs.yml

plugins:
  - drawio

To use a custom source for the drawio viewer JavaScript file you can overwritte the url.

plugins:
  - drawio:
      viewer_js: "https://viewer.diagrams.net/js/viewer-static.min.js"

After mkdocs has generated the html for your documentation, this plugin adds the necessary drawio javascript library. Searches for img tags with a file ending of *.drawio and replaces them with the appropiate mxgraph html block. For further details, please have a look at the official drawio.com documentation.