xolox/vim-notes — comment on commit e706a98a599a745f67acbb74f501532fab619357
File:  line 0
By xolox:

Of course you're right, I love Markdown (*most of the time*). That's why I use it in my GitHub readmes, on my own website, etc. I even wrote a [converter](https://github.com/xolox/vim-tools) from Markdown to Vim help file format. However every once in a while one of the more complicated corner cases of Markdown syntax bites me in the ass, and of course I don't notice until I've already published the new version and my GitHub project page and homepage are broken. Then I go to vent my frustration on GitHub... Probably not the best venue for my frustration, but hey, these are open source projects so the world gets to see it all, the good and the ugly :-).

In this particular case, I guess the separate headings are an improvement because now I can link to individual items on my homepage (the backend automatically creates anchors for all headings).