С вашей точки зрения на что должна быть похожа (или не похожа) строка комментария что бы по ней и документация легко генерилась, и читалось легко?
Вот я лично склоняюсь к мысли что javadoc вполне  подходит.

Имхо, самым полезным было бы не изобретение собственного, а анализ существующей структуры документирования подпрограмм в 1С. Бывают же перед некоторыми функциями / процедурами их описания. Другое дело, что структура такого описания не имеет явной формализации.

(1) Я вас обожаю.

wiki:Javadoc