I've been told it is possible to hyperlink to sections within a markdown document. If so please arrange for that to happen in both PSR-1 and PSR-2. Thanks.
A table of contents would be superb as well.
For reference, I believe the syntax for hyperlinking within a markdown document is:
[Name of Link]
If that doesn't work like I think it does (although, otherwise I'm not sure how it's done in the following links), straight HTML should be a feasible soltuion.
This may also be of use: http://fletcher.github.com/peg-multimarkdown/index#cross-references
I don't think a table of contents would be practical in the long run. https://github.com/php-fig/fig-standards/tree/master/accepted essentially runs as a contents.
@unknownbliss he means within the document. If you are wanting to point someone to a specific coding standard within the document, you currently have to say "Go to the PSR-#, scroll down about midway to X Section, and find point Y". With a TOC, you could link directly to the section.
Github readme.md's automatically add links, its a shame they dont to it to all markdown files seeing as it parses them.
@p are you planning on adding hyperlinks into markdown documents for PSR 1/2 ?
They are mystery meat navigation in github but they are there, if you know where to look.
I'm closing this since it's just a suggestion to make things hyperlinks but no PR has been issued since it was opened 3 months ago. If someone is interested in doing this please make a PR. Thanks.