Create new markdown files for examples

[ageddesi]

On the website I would like to include example of how to use the API.

This should be in the form of markdown files. If we can embed live examples as well this would be great.