Document Markdown table formatting issue

Add a note to the Markdown documentation about a quirk of Redcarpet's
table parsing.
Merge pull request #8017 from mr-vinn/md-table-doc

Document Markdown table formatting issue