Add a Known Issues section to the README.

The Known Issues section includes a bullet describing the problem where line comments in a table causes "not found" errors for images in that table.