For example see:
In the "Response Body" table the link to the introduction section is not provided as link:
"See the [Introduction](/api-references/rest/#!/overview/introduction) for..."
The problem is that a link written in MD does not work within an HTML-table, the link has to be provided as a <a>-element.
Furthermore, all sections have to be checked in the REST API docs.