I'm a step further along the process - the markdown content comes into play when submitting your add-on for private beta. In the meantime, you'll need to provide your own documentation source for your alpha testers (unless I missed something - I guess someone from Heroku can correct me :)
Cheers
--
Pat