update sample code in README; fix API docs; add markdown parsing
update test support in README