README updated with markdown format.

The README now follows the markdown format, suitable to display in the GitHub repository site. Also, the documentation in this file has been slightly extended.