Is there a way to create a folder-specific readme file in github?

Github parses and displays a readme.txt or readme.md file at the root of the repository.

I would like to create a similar readme file for a particular folder. Is there a way to accomplish this?

One ugly hack I thought of was to name the file _readmeme.md causing it to appear as the first file in the folder, and making it easy for users to find and click it. - it doesn't work, _README appears last and not first.

Solution 1:

GitHub already has this feature. Just put your README file in a subdirectory, and it will be displayed just like one in the root directory.

For example, see README.md for this subdirectory: http://github.com/larsbrinkhoff/lbForth/tree/master/targets

Solution 2:

One thing I just tried that works is use the .md extension on the README file, so README.md and github is smart enough to display it using markdown (way better than plain text).