improve readme
footnotes should support inline elements
trailing hash characters should get trimmed
add tests
update requirements
Merge remote-tracking branch 'upstream/master'