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 https://github.com/danielfrg/mkdocs-jupyter/issues/99 Plotly.py docs branch to try this out https://github.com/plotly/plotly.py/tree/api-docs