doc: use the markdown format instead; also added more detailed documentation.

Author: agentzh