Document Markdown table formatting issue

Add a note to the Markdown documentation about a quirk of Redcarpet's table parsing.  See issue #3651