Document Markdown table formatting issue

Created by: mr-vinn

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