Registry / devops / mkdocs-callouts

mkdocs-callouts

library1.16.1pypypiunverified

A MkDocs plugin that converts Obsidian-style callouts (e.g., > [!note]) into MkDocs admonitions. This version (1.16.1) requires Python >=3.8 and is actively maintained with monthly releases.

devops

pip install mkdocs-callouts

INSTALL

IMPORT

SIG · MKDOCS-CALLOUTS

mkdocs-callouts

devopspythonv1.16.1

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

MkDocsCalloutsPlugin

✓ from mkdocs_callouts import MkDocsCalloutsPlugin

✗ from mkdocs_callouts.plugin import MkDocsCalloutsPlugin

Enable the plugin in mkdocs.yml with `plugins: - callouts`. No other configuration needed.

import mkdocs from mkdocs_callouts.plugin import MkDocsCalloutsPlugin # In mkdocs.yml: # plugins: # - search # - callouts # Requires 'callouts' as plugin name, not 'mkdocs-callouts'

Debug

Known issues

gotchaThe plugin name in mkdocs.yml must be `callouts`, not `mkdocs-callouts`. Using the package name will cause a plugin not found error.

fix

In mkdocs.yml, use `plugins: - callouts`

affects: all

breakingVersion 1.0.0 changed the import path from `mkdocs_callouts` directly to `mkdocs_callouts.plugin`.

fix

Update imports to `from mkdocs_callouts.plugin import MkDocsCalloutsPlugin`

affects: <1.0.0

gotchaIf using with `pymdownx.superfences` or other nested admonitions, callouts may not render correctly due to conflicting syntax.

fix

Disable or reorder plugins to avoid conflicts.

affects: all

Upgrade

Version history

1.16.1latest on PyPI · released May 13, 2026

Audit

Dependencies

mkdocsrequiredRequired plugin architecture

Agent activity

4 hits · last 30 days

node

Resources

No resource links recorded.