Накидал скрип для создания документации на основании спец.меток в модулях.
За основу взята разметка в стиле Markdown.

пример прилагается. в т.ч. приложил найденное в сети описание формата.

сделано не оптимально, но работает.
сейчас есть проблема с формированием кода при выгрузке (тег code), убирает ведущие пробелы
Для работы скрипта необходимо создать в каталоге иб папки: Documentation\txt, Documentation\html

дополняю, как просили в 1.

пример документации в ГМ:

//! #Глобальный модуль
//! ##Описание процедур и функций
//!
//i какой-то текст
//!
//! - список 1
//! - список 2
//! - список 3
//!  - список 3.1
//! Пример кода:
//! <pre>
//! <code>
//! Функция глФрмСистема(пЗначение)
//! 	Возврат Формат(пЗначение,"Ч19.2"+Разделитель);
//! КонецФункции;
//! </code>
//! </pre>
//! >цитата 1  
//! >цитата 2
//! >>цитата 2.1
//!
//! продолжим описание ГМ  
//!
//! продолжим описание ГМ 2
//! Снова Заголовок 1 уровня
//i ===
 

Обновил скрипт.
Появилась возможность создать пользовательскую и техническую документацию (различные теги)
Исправлены найденные ошибки
пример

	//tech Создаем структуру ТЧ 2
	//i Создаем структуру ТЧ 2
 

Польза
- создание прототипа документации для пользователей.
- документирование кода, для упрощения понимания и доработки.
Как пример: добавил подобное описание к модулю, сформировал документацию, отдал админам 1С, чтобы не приставали с вопросами: а как получается то или это ...

читать код умеют лишь те, кто так или иначе знаком с программированием и назначением тех или иных методов языка.
у нас есть четкое разделение - разработчик и админ.
админы читать код не умеют. и конфиг всегда занят. а админов много.
опять же, пока документируешь - заново простраиваешь логику.