Improved command documentation, and converted all .rst into md.

In the case of the latter, I am not quite sure if it's good in the current form,
as it is redundant compared to the output of '-h' of pgit.

It would be better to show some more complex examples, including their
output.