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 )