@wilfredh Unfortunately, yes. First teachers make their students shoot themselves in the foot by treating comments as whitespace. Then everyone has to do extra work with crazy grammars to claw the structure back and/or make a formatter.
@wilfredh Maybe Erlang?
-doc """
some markdown inside
""".
I don't know about its rep, but looks pretty first-class.
Python also yes, with the __doc__ attribute you can access AND generate at runtime.
@dpwiz First class comments are pretty darn rare, aren't they? I know some lisps and Python use a plain string for their doc comment, but I've not seen proper first class comments in any language I can think of.
Maybe Smalltalk comes close?