Currently if a HTML comment is encountered in a markdown file it is escaped and displayed literally. Most implementations treat the comment as HTML and pass it through.
<!-- This gets escaped and displayed, but it would be nice if it was a HTML comment. -->
Additionally, some implementations completely remove comments with three leading dashes.
<!--- It would be nice if this was removed completely. -->