add a comment in the readme to warn for issues like #5 (fixes #5)
Back to markdown docs, remove html table