README.md

August 11, 2026 · View on GitHub

screenshot

Important

This is an unofficial port of shadcn/ui to MkDocs, and is not affiliated with @shadcn.

Documentation

Yes, yes, the documentation is built with this theme.

mkdocs-shadcn can be installed with pip (you may also need Pygments for syntax highlighting).

pip install mkdocs-shadcn

Add the following line to mkdocs.yml:

theme:
  name: shadcn

Note

MkDocs is stale. You can use ProperDocs as a drop-in replacement.

The theme tries to support the built-in extensions along with some pymdownx ones.

builtin excalidraw - With this plugin, you can directly edit your excalidraw scene in dev mode (kind of WYSIWYG) while it is rendered as svg at build time
mkdocstrings - a MkDocs plugin for auto-generating API documentation from docstrings. (alpha)
taylor-made autonumber plugin to automatically number and reference some elements (figures, tables, equations...)
mike - A Python utility that makes it easy to deploy multiple versions of your MkDocs-powered docs to a Git branch.

This project is open to contributions. In general, we need to apply the shadcn/ui style to already existing plugins or extensions.

We recently release the css sources we use to style the theme. It mainly uses tailwindcss.

First clone the repo:

git clone https://github.com/asiffer/mkdocs-shadcn
cd mkdocs-shadcn

Then you can install python dependencies (uv required),

uv sync --all-extras

and pre-commits:

uv run pre-commit install

Finally, you can install tailwind with your favourite package manager (npm, yarn, bun, etc.):

bun install

We use the project pages to as a test project for this theme. You can run the local server in the pages/ subdirectory.

cd pages/
uv run mkdocs serve --watch-theme -w ..

In parallel, you are likely to run the tailwind watcher to compile the css sources. In the root folder:

bun dev

Tests are managed by pytest and are located in the tests/ folder.

Currently we test:

You can run them as follows.

uv run pytest -xvs .