README: convert to Markdown, add function descriptions and examples