This is the help for comments:

Comments use mini-Markdown formatting: [link](http://example.com) _italic_ **bold** `code`. The post author will always be notified of your comment. To also notify a previous commenter, mention their user name: @peter or @PeterSmith will both work. Learn moreā€¦

I've stumbled often over [link](http://example.com) because the link is not the "link", but the text that is linked. I often find myself putting the URL in the link part because it is confusing.

Proposed changes

Here are two alternatives to make the help text for that tag a bit clearer; maybe the community can identify better ones.

option 1


option 2


What do you think?

  • +1 And while this might be immediately obvious to the more tech savvy, note that there are now many sites in SE where the audience might be misled by this description. Commented Oct 18, 2012 at 23:03
  • +1! I was just working on a question about this, it has bugged me a couple of times. Wish I could bump it 8)
    – smcs
    Commented Jan 6, 2021 at 15:58


You must log in to answer this question.

Browse other questions tagged .