If writing .md markdown instructions (e.g. Installation instruction steps), what would be the best way to give a note, why specific step is needed, some give some references.


In other words, if I write .sh, I can add # like

# this step is optional, but recommended by https://documentation.ubuntu.com/
sudo apt-get update

So how would I add comment to a line of markdown text ?


This question is not about how to comments out a portion of .md file, for that one can use HTML tags

to comment/disable anything inside .markdwon use HTML comments
<!--
anything here is invisible
-->

So using the above example, how can I add a comment/a note text to the line
"to comment/disable anything inside" ?