more markdown corrections.
added tests.
added example.
enhanced readme.