Not compatible with mkdocs's admonition

[TiborVoelcker]

A widely used mkdocs plugin is introducing admonitions. I have a lot of code examples in expandable admonitions, like so:

??? quote
    
    ```python
    x = 1
    ```

Using this syntax, the code blocks are not tested.

I believe this is because markdown_it does not recognize it. There should be a plugin available for markdown_it which introduces this syntax so it can be parsed correctly. Maybe there could be a configuration option to add plugins to markdown_it?

[freider]

Happy to accept contributions for this! :)

[TiborVoelcker]

I gathered some information about this. Note that I did not test any of this yet.

The plugins can be added like this with the example of the admonition:

from markdown_it import MarkdownIt
from mdit_py_plugins.admon import admon_plugin


from mdit_py_plugins import plugin1, plugin2
md = MarkdownIt().use(admon_plugin)

This would need to be added to

pytest-markdown-docs/src/pytest_markdown_docs/plugin.py

Line 192 in 2950d1f

mi = markdown_it.MarkdownIt(config="commonmark")

Then there is the question regarding the configuration which plugins should be loaded. As this is a pytest plugin, the possibilities are quite restricted.
It could be possible with pytest_addoption.
This might be cumbersome, but possible. One could define an option where a list of plugins are input. These are the parsed and loaded.

Things get even more complicated, as some md plugins have parameters that can be specified at initialization. Not sure how to handle this.

Another idea would be to just use ALL plugins, but this does not sound like a good idea.

[TiborVoelcker]

I sadly don't have the time to try some things out or even make a PR. But I wanted to add the information I gathered if someone else wants to take a look. Or maybe even future me.