Use rst so it can be used by sphinx as documentation.
Changed markdown to restructured text.