We are looking at using mk-docs jupyter to run example notebooks in the docs, but we currently can't required metadata to the pages
danielfrg/mkdocs-jupyter#99
Plotly.py docs branch to try this out https://github.com/plotly/plotly.py/tree/api-docs