You may have confused it a bit (probably I explained it to you wrong), the only part of `README.md` that is generated automatically is the options description , the rest (FAQ, documentation of the output template ...) is manually edited.
pandoc is used to convert the README.md to a plaint text file (README.txt) and to generate the manpage (youtube-dl.1).