that’s a good explanation of a use case where a dedicated functionality for comments would be really useful.
In general even though !<-- html comments --> technically work for simple stuff (without [[links]] and #tags) I find html comments syntax a bit annoying.
Personally I use this format mentioned somewhere in this thread
[//]: # (comment goes here)
however it has the same limitation that @EleanorKonik explained.
Personally what I’d really like is a clean syntax.
Regarding @EleanorKonik 's request, it kind of goes beyond what normal commenting out does, so what we would need is something like a customizable plug in that has the functionality to still allow for certain elements to work such as [[double square links]] that could perhaps only show in edit mode, but not in preview mode.