Home → Markdown → Comments

How to add comments in Markdown

Markdown has no native comment syntax. The standard workaround is an HTML comment — <!-- … --> — which most Markdown renderers leave out of the final output.

HTML comments

Anything between the markers is ignored when rendered, and works for single or multiple lines:

<!-- This is a comment. It won't appear in the rendered output. -->

Visible text here.

<!--
Comments can
span multiple lines.
-->

Important gotchas

• The comment is hidden in the rendered page, but it's still present in the raw .md file — never put secrets in it.
• A few strict renderers may still display HTML comments; test in your target tool. (Our live editor hides them, as GitHub does.)
• Put a blank line before and after a block comment to avoid it merging with nearby text.

Related: cheat sheet · code blocks.