schemas: change to github flavoured markdown