I like docco-husky[1]. Just add comments inline with Markdown and you get nicely generated literate programming style documentation.

[1] https://github.com/mbrevoort/docco-husky