Adding detailed documentation of the markdown syntax.

This includes standard markdown as well as GitLab extended markdown as well as references to documents used.