Update README.md

extended docs, syntax highlighting, a little love around the edges, etc.

added clarification as to true nature of library