# Промт: написание работы в MD-диалекте «Оформителя»

Скопируй этот промт целиком в диалог с ИИ (ChatGPT, Claude, GigaChat…), а после него
добавь своё задание: тему работы, план, требования. ИИ выдаст текст, который можно
вставить в «Оформитель» без правок — оформление по ГОСТ сервис сделает сам.

---

Ты пишешь учебную/научную работу в специальном Markdown-диалекте сервиса
«Оформитель» (ГОСТ 7.32). Сервис сам расставляет: номера разделов, подписи
«Таблица 1 — …» / «Рисунок 1 — …», номера формул, маркеры списков и пунктуацию
пунктов, типографику (кавычки-«ёлочки», тире, неразрывные пробелы). Твоя задача —
только содержание и правильная разметка. Строго соблюдай правила ниже.

## Структура документа

- Каждый раздел начинается с заголовка первого уровня `#`.
- Стандартные разделы распознаются по названию: `# Реферат`, `# Содержание`,
  `# Введение`, `# Заключение`, `# Список использованных источников`,
  `# Термины и определения`, `# Перечень сокращений и обозначений`.
- Любой другой `#` — это глава: она получит номер автоматически («1 Название»).
- Подразделы: `##` → «1.1», пункты: `###` → «1.1.1». Номера НЕ писать.
- Приложения: сначала строка-открыватель `# Приложения` (ровно это слово), а
  дальше каждое приложение — обычный заголовок `#`, текст которого = НАЗВАНИЕ
  приложения. Слово «Приложение», литеру (А, Б, …) и статус сервис добавит сам;
  статус задаётся атрибутом `{status=справочное}`. Пример:

  ```
  # Приложения

  # Схема базы данных {status=справочное}
  Текст приложения…

  ## Структура таблиц
  ```

  Шапка «Приложение А (справочное)» + название на новой строке и нумерация
  «Таблица А.1» / «Рисунок А.2» / подраздел «А.1» — всё авто. Обозначение
  «Приложение А» руками не писать.
- Метаданные в начале файла не обязательны. Если нужны — YAML-блок:

```
---
author: {fio: "Иванов И. И.", group: "ИБ-21"}
year: 2026
---
```

## Рамка (основная надпись)

Если профиль оформления рисует рамку ГОСТ (например `gost_2.105`) — заполни
графы штампа СЛУЖЕБНОЙ ТАБЛИЦЕЙ `::: frame`, один раз в любом месте документа
(удобнее всего сразу после front matter). В готовый текст эта таблица не
попадает — только заполняет графы штампа:

```
::: frame
| Графа       | Значение        |
|-------------|-----------------|
| Разраб.     | Иванов И. И.    |
| Пров.       | Петров П. П.    |
| Н. контр.   | Сидоров С. С.   |
| Утв.        | Кузнецов К. К.  |
| Наименование | Пояснительная записка |
| Обозначение | ПЗ.02.03.06.000 |
| Литера      | У               |
:::
```

Допустимые графы: Разраб., Пров., Н.контр., Утв., Наименование, Обозначение,
Литера, Организация — название графы пиши как на штампе, точку на конце и
регистр сервис сам приведёт к нужному виду. Наименование можно не заполнять:
тогда в графу пойдёт `title` работы; заполненное — сильнее заголовка (удобно,
когда заголовок длинный, а графа узкая). Лист и листов заполняются
автоматически — их в таблицу не вписывать. Графы «Т.контр.» в формах рамки
нет: вписанная, она даст замечание и в штамп не попадёт.

## Реферат

Первая строка — статистика с полями-подсчётами (значения посчитает сервис,
писать числа руками нельзя):

```
# Реферат

Отчёт {PAGES} страниц, {IMAGES_COUNT} рисунков, {TABLES_COUNT} таблиц, {SOURCES_COUNT} источников, {APPENDIX_COUNT} приложений.

:::keywords
КЛЮЧЕВОЕ СЛОВО, ДРУГОЕ КЛЮЧЕВОЕ СЛОВО, ТРЕТЬЕ
:::

Текст реферата: объект, цель, методы, результаты.
```

Ключевых слов — от 5 до 15, ПРОПИСНЫМИ, через запятую.

## Таблицы

Обычная pipe-таблица; подпись — строка с `:` сразу после таблицы, идентификатор —
`{#id}`. В тексте ДО таблицы обязательна отсылка `{ref:id}`:

```
Сравнение приведено в таблице {ref:tbl_cmp}.

| Алгоритм | Точность, % | Время, с |
|----------|-------------|----------|
| CNN      | 94,2        | 120      |
| RNN      | 91,5        | 180      |

: Сравнение характеристик алгоритмов {#tbl_cmp}
```

Пустых ячеек не оставлять — ставить прочерк «–». Десятичные дроби — с запятой (94,2).

## Рисунки и диаграммы

Готовый файл-картинка. Путь всегда `assets/<имя>` — папка `assets/` в корне
рядом с `.md`, без подкаталогов. Имя любое: `arch.png`, `01_equipment.png`.
Хешировать не нужно.

```
Архитектура показана на рисунке {ref:fig_arch}.

![Архитектура системы](assets/arch.png){#fig_arch}
```

Если файлов рисунков нет — всё равно пиши такие пути (подпись и `{#id}`
полностью): пользователь вставит картинки в редакторе (перетаскивание / буфер)
или соберёт архив сам.

Если файлы у тебя есть — не встраивай их в текст, отдай работу архивом
`.md.zip`:

```
работа.md                 ← один .md в корне архива, не во вложенной папке
assets/arch.png
assets/01_equipment.png
```

Форматы: png, jpg, gif, bmp, tiff. Имена в ссылках = имена файлов в `assets/`.
Пользователь открывает архив в «Оформителе»: меню «Файл → Открыть» или кабинет →
загрузить с устройства. Сервис сам положит картинки в стор и перепишет пути.

Диаграмму предпочтительно описывать кодом — сервис отрисует её сам:

````
Сценарии показаны на рисунке {ref:fig_uc}.

```plantuml {#fig_uc caption="Диаграмма вариантов использования"}
@startuml
actor Пользователь
Пользователь --> (Собрать документ)
@enduml
```
````

Поддерживаются plantuml, mermaid, graphviz/dot, d2, ditaa, erd, bpmn, dbml,
wavedrom, vega и другие языки Kroki. Отсылка `{ref:id}` в тексте до рисунка обязательна.

Размер диаграммы задаётся так же, как у картинки — атрибутом `width` на
открывающей строке блока (в мм; высоту сервис подберёт по пропорции):

```mermaid {#fig_uc width=120mm caption="Диаграмма вариантов использования"}
```

Один рисунок на нескольких листах: у первого листа — обычный `{#id}` и подпись, у
продолжений — `{sheet_of=id}` (без своей подписи). Сервис сам посчитает и допишет
«(лист 1 из 3)», «(лист 2 из 3)» …, номер рисунка один на всю группу:

```
![Схема алгоритма](img/algo1.png){#fig_algo}
![](img/algo2.png){sheet_of=fig_algo}
![](img/algo3.png){sheet_of=fig_algo}
```

## Формулы

Блочная формула — LaTeX в `$$ … $$`, идентификатор — атрибутом после; номер «(1)»
у правого края поставится сам. Расшифровка переменных — блок `::: where`
(слово «где» и выравнивание сделает сервис):

```
Потери считаются по формуле {ref:eq_loss}.

$$ L = -\frac{1}{N}\sum_{i=1}^{N} y_i \log(\hat{y}_i) $$ {#eq_loss}

::: where
- $N$ — размер выборки;
- $y_i$ — истинная метка примера.
:::
```

Встроенная формула в тексте — `$…$`: «скорость $v$ растёт».

## Листинги (код)

Блок кода с `caption=` станет нумерованным листингом («Листинг 1 — …»); без
caption — простым блоком кода:

````
```python {#lst_pre caption="Функция предобработки данных"}
def preprocess(text):
    return text.lower().split()
```
````

## Списки

Обычные MD-списки; маркеры («–», «а)», «1)») и знаки в конце пунктов («;», «.»)
подставит сервис — не писать их руками:

```
В состав системы входят:

- модуль аутентификации
- модуль шифрования
  - симметричное AES-256
  - асимметричное
```

Глубина вложенности задаёт вид маркера: 1-й уровень «–», 2-й «а)», 3-й «1)»,
4-й «I)» (римский). Нумерованный `1.` остаётся арабским на любой глубине.

## Спец-блоки

- `:::note … :::` — примечание (станет «Примечание – …»; в стилях с группировкой,
  как gost_2.105, несколько примечаний подряд дают заголовок «Примечания» и
  нумерацию «1 …», «2 …»).
- `:::example … :::` — пример (станет «Пример – …»; группируется так же, как
  примечания → «Примеры»).
- `> текст` — цитата.
- `:::pagebreak` — принудительный разрыв страницы.
- `::: landscape … :::` — широкая таблица/рисунок на альбомной странице.

Термины и сокращения — по абзацу на статью «Термин – определение» в своём разделе
(тире набираете сами; хвостовую точку/запятую/точку с запятой сервис снимет; без
красной строки). Допустима и таблица из двух колонок «термин | определение».

```
# Перечень сокращений и обозначений

ИНС – искусственная нейронная сеть

API – программный интерфейс приложения
```

## Источники и цитирование

В тексте — `[@ключ]`, номер `[N]` подставится по порядку первого упоминания.
Список — в разделе источников, ключ в начале записи:

```
Как показано в [@olifer], сети растут.

# Список использованных источников

- {#olifer} Олифер В. Г., Олифер Н. А. Компьютерные сети. — СПб.: Питер, 2020. — 1008 с.
```

Источников для серьёзной работы — не меньше 15.

## Запрещено (валидатор отметит как нарушение)

1. Ручная нумерация: НЕ писать «Рисунок 1», «Таблица 2», «(3)», «1.2 Название» —
   только `{ref:id}` и чистые заголовки.
2. Таблица или рисунок без отсылки `{ref:id}` в тексте ДО объекта.
3. Рисунок без подписи.
4. Пустые ячейки таблиц без прочерка «–».
5. Таблицы, рисунки, формулы и код в разделах Реферат, Введение, Заключение.
6. Ручные маркеры списков («а)», «1)») и знаки препинания в конце пунктов.

Пиши научным стилем, безлично («был разработан», «проведён анализ»).

## Формат ответа (строго!)

1. Выдай ТОЛЬКО текст документа — без вступлений, пояснений и «вот ваш документ».
2. Весь документ — ОДНИМ блоком кода, открытым и закрытым ЧЕТЫРЬМЯ обратными
   кавычками (````). Именно четырьмя: внутри документа есть блоки с тройными
   кавычками (диаграммы, листинги) — тройная обёртка сломается об них, и часть
   текста отрендерится как обычный текст вместо кода.
3. Ничего после закрывающих кавычек не добавляй.
4. Если есть файлы рисунков и умеешь отдавать вложения — дополнительно приложи
   архив `.md.zip` (один `.md` в корне + папка `assets/`, см. «Рисунки»). Текст
   в архиве тот же, что в блоке кода.

Пример каркаса ответа:

`````
````
# Реферат

...весь документ...
````
`````

Если тебе пришлют замечания валидатора (строки вида «КОД · раздел: описание»),
исправь документ по каждому замечанию и выдай ЗАНОВО ЦЕЛИКОМ в том же формате —
не отдельные исправления, а весь документ.