Use heading sintax

[paulochang]

@raohmaru Pointed to me that Github already adds links when using the Heading syntax.
To keep the markdown simple, it would probably be good to change our docs to use this functionality directly instead of creating the links manually as we do right now.

It should be noted however, that this might make our docs less portable if we want to migrate out.