author examples as .py files?

[jgunstone]

thanks for the great package - its really easy to use and useful.

I was wondering if it could be possible to author the examples as python files rather than markdown files with python code blocks?
... because writing the python code in a .md without the benefit of code-completion etc. is a little painful

maybe:

• by embedding a python file into the markdown examples file at runtime (<< include myexample.py >>)
• or perhaps as a %format python file with %[markdown] blocks?

or maybe you already have a way to avoid this irritation?

many thanks

[Danipulok]

Hey!

You can see an example here:
https://github.com/pydantic/pydantic-ai/blob/a84f2b31d14de3572d51676ea1839c031d85362a/docs/agent.md?plain=1#L26-L55