Enable Pytest Examples to print outputs into the markdown

As mentioned in the README, we need to enable Pytest examples to print outputs into the markdown documentation.

Description

When running tests, add a mechanism to capture the outputs and incorporate them into the markdown documentation automatically.

Tasks

• Find a suitable approach to capture pytest outputs
• Add mechanism to insert these outputs into markdown files
• Ensure the output formatting is consistent with markdown syntax
• Update documentation to explain how this feature works

Why is this important?

This will help keep code examples and their outputs in sync, improving documentation accuracy.

Difficulty

Good first issue - suitable for new contributors