78

Is there a way to comment out a single line in HTML using just an escape sequence at the start of the line?

Similar to using # or // in other languages? Or is <!-- ... --> the only option for commenting in HTML?

1
  • 3
    TL;DR: No. <!-- --> only.
    – Andrew
    Jul 14, 2020 at 20:32

5 Answers 5

75

From HTML comments:

Since HTML is officially an SGML application, the comment syntax used in HTML documents is actually the SGML comment syntax. Unfortunately this syntax is a bit unclear at first.

The definition of an SGML comment is basically as follows:

A comment declaration starts with <!, followed by zero or more comments, followed by >. A comment starts and ends with "--", and does not contain any occurrence of "--".
This means that the following are all legal SGML comments:
  1. <!-- Hello -->
  2. <!-- Hello -- -- Hello-->
  3. <!---->
  4. <!------ Hello -->
  5. <!>
Note that an "empty" comment tag, with just "--" characters, should always have a multiple of four "-" characters to be legal. (And yes, <!> is also a legal comment - it's the empty comment).

Not all HTML parsers get this right. For example, "<!------> hello-->" is a legal comment, as you can verify with the rule above. It is a comment tag with two comments; the first is empty and the second one contains "> hello". If you try it in a browser, you will find that the text is displayed on screen.

There are two possible reasons for this:

  1. The browser sees the ">" character and thinks the comment ends there.
  2. The browser sees the "-->" text and thinks the comment ends there.
There is also the problem with the "--" sequence. Some people have a habit of using things like "<!-------------->" as separators in their source. Unfortunately, in most cases, the number of "-" characters is not a multiple of four. This means that a browser who tries to get it right will actually get it wrong here and actually hide the rest of the document.

For this reason, use the following simple rule to compose valid and accepted comments:

An HTML comment begins with "<!--", ends with "-->" and does not contain "--" or ">" anywhere in the comment.
9
  • 6
    Interesting, I never knew <!> was a valid comment. I'd avoid things like that just for compatibility's sake though Apr 14, 2010 at 19:52
  • 2
    AFAIK HTML5 has moved away form the SGML comment syntax, since it is no longer based on SGML.
    – Yuhong Bao
    Jun 19, 2011 at 19:40
  • 1
    Yes, now with HTML5 comments must begin with <!--, end with --> and the text must not start with > or ->, not contain -- and not end with -. But there are loads of rules for parsing invalid comments browsers can adhere to.
    – Robert
    May 28, 2016 at 12:37
  • 2
    Downvote for not actually addressing the question but instead providing a bunch of extraneous detail.
    – Andrew
    Jul 14, 2020 at 20:30
  • 3
    @aslum This doesn't answer the question. At all.
    – Andrew
    Jul 15, 2020 at 23:01
44

No, <!-- ... --> is the only comment syntax in HTML.

1
  • 2
    This should be the only answer to this question.....
    – Andrew
    Jul 14, 2020 at 20:31
8

Let's keep it simple. I loved digitaldreamer's answer, but it might leave the beginners confused. So, I am going to try and simplify it.

The only HTML comment is <!-- -->. It can be used as a single line comment or double; it is really up to the developer.

So, an HTML comment starts with <!-- and ends with -->. It is really that simple. You should not use any other format, to avoid any compatibility issue even if the comment format is legitimate or not.

5

No, you have to close the comment with -->.

3

TL;DR: For conforming browsers, yes; but there are no conforming browsers, so no.

According to the HTML 4 specification, <!------> hello--> is a perfectly valid comment. However, I've not found a browser which implements this correctly (i.e. per the specification) due to developers not knowing, nor following, the standards (as digitaldreamer pointed out).

You can find the definition of a comment for HTML4 on W3C's website: 3.2.4 Comments

Another thing that many browsers get wrong is that -- > closes a comment just like -->.

1
  • 1
    How does that mean that for "conforming browsers", there's a syntax for opening a comment which ends at the end of the line? The correct answer is "For conforming browsers, no; but for actual browsers, also no." Apr 21, 2017 at 16:52

Not the answer you're looking for? Browse other questions tagged or ask your own question.