---
id: mkdocs-jupyter
version: "0.26.3"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# mkdocs-jupyter — Use Jupyter in mkdocs websites

License: permissive · Maintenance: active · Downloads: 514.9K/mo

## What it is and what it does

mkdocs-jupyter is a plugin that embeds Jupyter notebooks directly into mkdocs documentation sites. Instead of manually converting notebooks to Markdown, you reference `.ipynb` or `.py` files in your mkdocs navigation, and the plugin handles rendering them with Jupyter's native styling, code highlighting via Pygments, and optional notebook execution before conversion.

The plugin supports multiple rendering modes: you can show full code and output, hide code input, remove prompts, or selectively hide cells using tags. It also handles ipywidgets, caches conversion results for faster rebuilds, and integrates with mkdocs themes like Material. Configuration is done entirely in `mkdocs.yml`, making it straightforward to add notebook pages to existing documentation projects.

Use it for:

- Publishing data science tutorials or analyses as part of technical documentation without manually converting notebooks to Markdown.
- Building API documentation that includes executable examples and visualizations rendered from Jupyter notebooks.
- Creating educational materials where notebooks serve as both the source and the published content, keeping them in sync.
- Generating reports or dashboards that combine narrative text, code, and interactive outputs in a static documentation site.
- Sharing reproducible research or methodology documentation where the notebook source is available for download.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Converts Jupyter notebooks and Python scripts into pages for mkdocs documentation sites, rendering them with notebook styling and optional execution.

Yes, if you maintain mkdocs documentation and want to include Jupyter notebooks as first-class pages. The plugin is stable (Production/Stable status), actively maintained, has no known vulnerabilities, and integrates cleanly into the mkdocs build pipeline. Install it when you have notebooks that belong in your docs and want to avoid manual conversion workflows.

## Install

pip install mkdocs-jupyter
uv add mkdocs-jupyter
poetry add mkdocs-jupyter

## Installing mkdocs-jupyter

Before you install: Low friction install with a pure-Python wheel. The package is actively maintained with a recent release and no known vulnerabilities. Six runtime dependencies (ipykernel, jupytext, mkdocs-material, mkdocs, nbconvert, pygments) are standard tools in the Jupyter and documentation ecosystem.

License in practice: Licensed under Apache-2.0 (permissive), allowing use in commercial and proprietary projects with minimal restrictions—only requiring license and copyright notice retention.

Quickstart:

pip install mkdocs-jupyter

# In mkdocs.yml:
nav:
  - Home: index.md
  - Notebook: example.ipynb
plugins:
  - mkdocs-jupyter

Requires mkdocs and its dependencies to be installed; notebooks are rendered during the mkdocs build process, not at runtime.

Verify before relying:

- Whether execution of notebooks with complex dependencies (e.g., GPU libraries, external services) works reliably in CI/CD environments.
- Performance characteristics when building documentation with many large notebooks or when execution is enabled.

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 514.9K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

jupyter notebooks in mkdocs, convert ipynb to documentation, mkdocs jupyter plugin, notebook documentation generation, jupyter to static site, ipynb mkdocs integration, jupyter-integration, static-site-gen, notebook-publishing

[View on SkillFed](https://skillfed.io/packages/mkdocs-jupyter) · [View on PyPI](https://pypi.org/project/mkdocs-jupyter/)