В этой статье вы узнаете, как добавлять файлы и изображения в статьи Wiki, как скачивать их в режиме чтения, а также какие типы файлов и размеры поддерживаются системой.

## Загрузка файлов в статью Wiki

При редактировании статьи вы можете прикрепить документы, изображения, видео или BPMN-модели. Это позволяет хранить регламенты, скриншоты и другие материалы непосредственно в контексте описания процесса.

Чтобы загрузить файл:

1. Откройте нужную статью в режиме редактирования.
2. Вставьте курсор в то место текста, где должен появиться файл.
3. Нажмите в панели форматирования иконку **«Картинка»** — для изображения или **«Файл»** — для документа.
4. В открывшемся окне выберите файл с компьютера.

![Кнопки «Картинка» и «Файл» в панели форматирования](https://helpdesk.stormbpmn.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBall1IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--a2b6d1683898746187724b759f2183bc94d64387/wiki_files_toolbar_2026-09-07.png)

Файл также можно перетащить в текст мышью или вставить из буфера обмена.

Система автоматически обработает файл и вставит его в текст. Изображения отображаются inline, остальные файлы — карточкой с именем, размером и типом. При наведении на карточку появляются действия: скачать, заменить файл, удалить.

![Вложенный файл в редакторе и действия при наведении на карточку](https://helpdesk.stormbpmn.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBamN1IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--11a808b624a5b951387cefd3743dde9b64bcbfaf/wiki_files_attachment_card_2026-09-07.png)

## Ограничения на типы файлов

В Wiki можно загружать только определённые типы файлов. Система проверяет расширение файла при загрузке.

Разрешены:

* Документы (PDF, DOC/DOCX, ODT, RTF, TXT, MD, CSV, XLS/XLSX, PPT/PPTX и др.);
* Изображения (JPG, PNG, GIF, WEBP, SVG, BMP, AVIF, HEIC, TIFF);
* Аудио и видео (MP3, WAV, OGG, M4A, FLAC, MP4, WEBM, MOV);
* Модели и схемы (BPMN, DRAWIO, PUML, XML, JSON, YAML).

Если вы попытаетесь загрузить неподдерживаемый формат, появится сообщение:

**«Нельзя загрузить: {расширение}. Разрешены документы, изображения, видео и модели»**

![Предупреждение о запрещённом формате файла](https://helpdesk.stormbpmn.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBamd1IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--e82f70bf45292cc8f0ed4c3cdab5e77fca4cb44f/wiki_files_denied_type_2026-09-07.png)

Также нельзя загрузить файл без расширения. В этом случае система покажет ошибку:

**«Файл без расширения загружать нельзя»**

Убедитесь, что у вашего файла есть корректное расширение, соответствующее одному из разрешённых типов.

## Ограничения на размер файла

Максимальный размер одного файла — **50 МБ**. Если файл больше, загрузка не начнётся, а редактор покажет сообщение **«Файл слишком большой. Максимальный размер: 50 МБ»**.

![Предупреждение о превышении максимального размера файла](https://helpdesk.stormbpmn.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBamt1IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--3dc64166fde630244a11138f3b6b90d2cc8bf1bb/wiki_files_too_large_2026-09-07.png)

Рекомендуется:

* Сжимать изображения и видео перед загрузкой;
* Разбивать большие документы на части;
* Для очень объёмных файлов давать ссылку на внешнее хранилище.

## Скачивание файлов в режиме чтения

Читатели статьи могут скачать вложенные файлы, даже если у них нет прав на редактирование.

Чтобы скачать файл:

1. Откройте статью в режиме чтения.
2. Найдите вложенный файл или изображение.
3. Нажмите кнопку **«Скачать»** на карточке файла.

![Кнопка «Скачать» у вложений в режиме чтения](https://helpdesk.stormbpmn.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBam91IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--b8fa40f8649a17e6350f02789f1b2cd654ae8ebc/wiki_files_download_read_2026-09-07.png)

Для изображений также доступна опция просмотра в полном размере по клику.

## Частые формулировки

«как вставить картинку в wiki», «не грузится файл в статью», «скачать документ из wiki», «ошибка нельзя загрузить расширение», «файл слишком большой wiki», «как прикрепить pdf к статье».