Hi,

I think I can help out. It's for example this plugin:

mkdocs-swagger-render-plugin

https://github.com/bharel/mkdocs-render-swagger-plugin

You can create the openapi.json with a script such as:

https://gist.github.com/johschmidt42/ff7626045361c04ecc7f398de0c2776f

Then you place this one next to the markdown file in which you want to reference the openapi.json and enter in the markdown file:

!!swagger openapi.json!!

That's it.