Make sphinx and readme compatible

Right now when building the documentation most of the warnings and errors originate from the inclusion of the README.md. This is probably because sphinx cannot parse all of the markdown contents like pictures although we use the markdown extension myst_parser.sphinx_. If we can resolve the compatibility issues here, this even might solve #94 (closed) .