---
id: mkdocs-techdocs-core
version: "1.7.0"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# mkdocs-techdocs-core — The core MkDocs plugin used by Backstage's TechDocs as a wrapper around multiple MkDocs plugins and Python Markdown extensions

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

## What it is and what it does

mkdocs-techdocs-core is an MkDocs plugin that packages Spotify's TechDocs documentation defaults into a single, drop-in component. It bundles theming (Material for MkDocs), multiple plugins (monorepo support, GitHub admonitions, search, redirects), and Markdown extensions (PyMdown, syntax highlighting, PlantUML, Graphviz inline rendering, and more) so you don't have to configure them individually.

Instead of manually adding and configuring a dozen separate MkDocs plugins and extensions, you install this package and add `techdocs-core` to your `mkdocs.yml`. It's designed for teams using Backstage's TechDocs feature but works as a standalone MkDocs plugin. The plugin supports optional features like material-based search indexing and PyMdown Blocks extensions via configuration flags.

Use it for:

- Generate documentation sites within Backstage TechDocs using pre-configured MkDocs defaults.
- Build monorepo documentation where multiple sub-projects need separate doc sets in one site.
- Create technical documentation with built-in support for PlantUML diagrams and Graphviz inline rendering.
- Standardize documentation styling and plugin configuration across a team or organization.
- Render GitHub-style alert syntax (NOTE, TIP, WARNING) as MkDocs admonitions without extra setup.

## Worth the install?

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

Bundles Spotify's TechDocs defaults—themes, plugins, and Markdown extensions—into a single MkDocs plugin for documentation generation.

Yes, if you are using Backstage TechDocs or want a pre-assembled, actively maintained MkDocs plugin bundle with Material theming and common extensions. The low install friction, permissive license, and zero known vulnerabilities make it safe to adopt. Not necessary if you prefer to configure MkDocs plugins individually or use a different documentation system.

## Install

pip install mkdocs-techdocs-core
uv add mkdocs-techdocs-core
poetry add mkdocs-techdocs-core

## Installing mkdocs-techdocs-core

Before you install: Low install friction with a pure-Python wheel. Actively maintained with a release 65 days ago. Supports current Python versions (3.9+).

License in practice: Apache-2.0 permissive license allows commercial and private use with minimal restrictions.

Quickstart:

pip install mkdocs-techdocs-core

# Add to mkdocs.yml:
plugins:
  - techdocs-core

# Optional: enable material search
plugins:
  - techdocs-core:
      use_material_search: true

Requires Python >= 3.9. Designed as an MkDocs plugin, so an existing mkdocs.yml configuration file is needed.

Verify before relying:

- Whether the 12 runtime dependencies (mkdocs, mkdocs-material, plantuml-markdown, etc.) are all actively maintained and compatible with each other.
- Performance impact of bundling all extensions and plugins together versus selective use.
- Compatibility with custom MkDocs themes or plugins not included in the bundle.

## Package facts

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

## Tags

mkdocs plugin documentation, techdocs backstage integration, mkdocs material theme wrapper, markdown documentation generator, mkdocs plugin bundle, documentation site builder, techdocs core plugin, mkdocs-plugin, backstage-integration, documentation-generation

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