Вот чем всегда раздражал синтаксис комментариев в XML/HTML <!-- --> это то что не поддерживается вложенность. Бывает понадобится временно закомментировать какой-то кусок кода, который уже содержит несколько комментов, а нельзя, всё ломается.

Но я придумал выход: вместо стандартных комментов оборачивать в тег <template></template>. Таким образом внутри может быть сколько угодно и других блоков <template>, и стандартных XML комментариев.

Как вариант до HTML5 можно было обернуть во что-то типа <script type="text/html"></script>, но в то время я почему-то не догадался.