Is mkdocs a requirement?

[eikek]

Hi, I just tried the example and run into the follownig:

❯ python
Python 3.13.3 (main, Apr  8 2025, 13:54:08) [GCC 14.2.1 20250322] on linux
Type "help", "copyright", "credits" or "license" for more information.
>>> from markdown import Markdown
... import markdown_exec.formatter
... import markdown_exec.validator
... 
... Markdown(
...     extensions=["pymdownx.superfences"],
...     extension_configs={
...         "pymdownx.superfences": {
...             "custom_fences": [
...                 {
...                     "name": "python",
...                     "class": "python",
...                     "validator": markdown_exec.validator,
...                     "format": markdown_exec.formatter,
...                 }
...                 # ...one fence for each language we support:
...                 # bash, console, md, markdown, py, python, pycon, sh, tree
...             ]
...         }
...     }
... )
... 
Traceback (most recent call last):
  File "<python-input-0>", line 2, in <module>
    import markdown_exec.formatter
  File "/test/.venv/lib/python3.13/site-packages/markdown_exec/__init__.py", line 15, in <module>
    from markdown_exec._internal.mkdocs_plugin import MarkdownExecPlugin, MarkdownExecPluginConfig
  File "/tests/.venv/lib/python3.13/site-packages/markdown_exec/_internal/mkdocs_plugin.py", line 10, in <module>
    from mkdocs.config import config_options
ModuleNotFoundError: No module named 'mkdocs'

I don't have mkdocs installed, because it is not needed. From reading the docs, it sounded as if there is an optional mkdocs plugin, so it wouldn't be required to have it. But the __init__.py file imports the mkdocs-plugin. Can I use this without mkdocs to programmatically convert markdown into markdown with code blocks replaced with the result?

[pawamoy]

Ah, looks like an oversight! Thanks for the report 🙂 I've published a bugfix release, let me know if that's better.

[eikek]

Thank you for the super quick reply and fix!