Plugins: intro

Blurry ships with a simple plugin infrastructure that makes it easy to write and register plugins that change how Blurry processes Markdown and HTML.

How to write a plugin

See the docs for the type of plugin you'd like to write:

• Plugins: write a Markdown plugin
• Plugins: write an HTML plugin
• Plugins: write a Jinja filter plugin
• Plugins: write a Jinja extension plugin

How to register a plugin

Plugins are registered using Python entry points.

To register your plugin, add it as an entry point in one of the following entry point groups in your package's configuration file (e.g., pyproject.toml or setup.py):

• blurry.html_plugins for plugins that modify the HTML Blurry generates from Markdown files
• blurry.markdown_plugins for plugins that add Markdown functionality via Mistune plugins

Examples

For a simple example of a Markdown plugin, see Blurry's own punctuation plugin: https://github.com/blurry-dev/blurry/blob/main/blurry/plugins/markdown_plugins/punctuation_plugin.py.

Blurry dogfoods its own plugin architecture, so you can use the Blurry source code as an example of writing a Blurry Plugin. See which plugins are registered in Blurry's pyproject.toml file.