grep '\*' src/\* | sed 's/\/\*/\#\#/g;s/^ \* //g;s/\*\///g;s/\*//g' >> README.md
So much tools, so little time.
If git repositories use markdown these days..
And mr. grep and mrs. sed are at your fingertips..
Then code-comments as markdown can be extracted easily perhaps?
( example output )