new and better readme!

new readme to fit the new API
Merge pull request #12 from tcarlsen/md-files

new and better readme!
Merge branch 'master' into issue/11-linenum-optional
Updated documentation to reflect that character is now optional.