-
Оценка
-
Установок3
-
Разработчик
Описание
Документы MD — это приложение, которое позволяет просматривать документацию, инструкции и базу знаний, хранимую на дисках Битрикс24 в формате "маркдаун", и удобно читать её с красивым форматированием прямо внутри портала.
Вместо того чтобы хранить документы в Word или Google Docs, вы пишете их в формате .md (Markdown) — простом текстовом формате с заголовками, списками, таблицами, кодом и ссылками. Приложение отображает эти файлы как красиво отформатированные страницы, и позволяет редактировать ссылки и вставлять картинки прямо из браузера, без скачивания файлов.
Данный формат сейчас становится популярным.
Самые важные особенности
Экран разделён на три части:
Разделитель между боковой панелью и областью просмотра можно перетащить — изменить ширину боковой панели. Разделитель между деревом папок и списком файлов тоже можно перетащить — изменить, сколько места занимает каждая секция.

Все возможности приложения
1. Выбор хранилища
В верхней части боковой панели находится кнопка с иконкой меню и названием текущего хранилища.
Что это даёт: в Битрикс24 может быть несколько дисков — Общий диск, Личный диск, диски рабочих групп. Приложение показывает все диски, к которым у вас есть доступ, и вы можете переключаться между ними.
Как использовать: нажмите на кнопку хранилища — откроется выпадающий список. Выберите нужный диск. Приложение перезагрузит дерево папок для выбранного диска.
При открытии приложение автоматически открывает Общий диск.
2. Навигация по папкам
В верхней части боковой панели отображается дерево папок текущего хранилища.
Как работает:
3. Список файлов и открытие документа
В нижней части боковой панели отображается список .md файлов из выбранной папки.
Что показывается для каждого файла:
Текущий открытый файл выделяется в списке.
4. Просмотр документа
Открытый документ отображается в области просмотра с полным Markdown-форматированием:
5. Масштаб картинок
В панели инструментов (над документом) есть поле «Масштаб для картинок» с числом в процентах.
Что это: позволяет уменьшить или увеличить все картинки в документе относительно их исходного размера.
6. История навигации (кнопки ← и →)
В нижней панели кнопок (под документом) слева расположены две кнопки со стрелками — назад и вперёд.
Что это: история открытых документов, работает как кнопки «назад/вперёд» в браузере, но только для переходов между .md файлами внутри приложения.
Как работает:
В нижней панели кнопок (между стрелками и кнопкой «Добавить картинку») расположена кнопка «Исходник» / «Просмотр».
Что делает: переключает режим отображения текущего документа.
В режиме Исходник кнопки вставки ссылок и картинок автоматически блокируются — редактирование доступно только в режиме Просмотр.
8. Вставка картинки в документ
Кнопка: «Добавить картинку» (иконка с горами).
Важно: картинки в документе отображаются только из той же папки, что и сам .md файл. Поэтому перед вставкой нужно загрузить изображение в ту же папку.
Как использовать:
Рекомендация: во избежание коллизий в ссылках на файлы избегайте названия, в которых используются символы, отличные от букв и цифр.

9. Вставка внутренней ссылки
Кнопка: «+ Внутренняя ссылка» (иконка документа).
Внутренняя ссылка — это ссылка с одного .md файла на другой .md файл, хранящийся на диске Битрикс24. При клике на такую ссылку в режиме просмотра приложение открывает целевой файл без перезагрузки страницы.
Как использовать:Нажмите на нужный .md файл.
Документа автоматически сохраняется.

10. Вставка внешней ссылки
Кнопка: «+ Внешняя ссылка» (иконка цепочки).
Внешняя ссылка — это ссылка на любой URL в интернете. В режиме просмотра такие ссылки открываются в новой вкладке браузера.
Как использовать:
В нижней части боковой панели расположена кнопка «Загрузить файл».
Что делает: загружает файл с вашего компьютера в текущую выбранную папку на диске Битрикс24.
Как использовать:
Это работает для любых файлов, не только .md. Таким образом можно загрузить картинки в папку, чтобы потом вставить их в документ.
Частые вопросы
Вместо того чтобы хранить документы в Word или Google Docs, вы пишете их в формате .md (Markdown) — простом текстовом формате с заголовками, списками, таблицами, кодом и ссылками. Приложение отображает эти файлы как красиво отформатированные страницы, и позволяет редактировать ссылки и вставлять картинки прямо из браузера, без скачивания файлов.
Данный формат сейчас становится популярным.
Самые важные особенности
- Файлы хранятся на диске Битрикс24 — не нужно отдельного сервера или хранилища. Все .md файлы лежат там же, где и остальные файлы вашего портала.
- Изменения сохраняются автоматически — когда вы вставляете ссылку или картинку, файл тут же обновляется на диске. Не нужно нажимать «Сохранить».
- Картинки берутся с того же диска — изображения, загруженные в ту же папку, что и .md файл, отображаются прямо в документе.
- Внутренние ссылки между документами — можно ссылаться с одного .md файла на другой, и переходить по ним прямо в приложении без перезагрузки страницы.
- Внутренние и внешние ссылки - можно добавлять только для простого текста, который не оформлен форматированием (заголовки, стили и т.п.)
- При добавлении картинки, она добавляется в конце форматированной строки, в которой вы выделили текст для добавления.
Экран разделён на три части:
Разделитель между боковой панелью и областью просмотра можно перетащить — изменить ширину боковой панели. Разделитель между деревом папок и списком файлов тоже можно перетащить — изменить, сколько места занимает каждая секция.

Все возможности приложения
1. Выбор хранилища
В верхней части боковой панели находится кнопка с иконкой меню и названием текущего хранилища.
Что это даёт: в Битрикс24 может быть несколько дисков — Общий диск, Личный диск, диски рабочих групп. Приложение показывает все диски, к которым у вас есть доступ, и вы можете переключаться между ними.
Как использовать: нажмите на кнопку хранилища — откроется выпадающий список. Выберите нужный диск. Приложение перезагрузит дерево папок для выбранного диска.
При открытии приложение автоматически открывает Общий диск.
2. Навигация по папкам
В верхней части боковой панели отображается дерево папок текущего хранилища.
Как работает:
- Папки с вложенными подпапками имеют стрелку ▸ слева — нажмите её, чтобы раскрыть подпапки.
- Нажмите ▾ на раскрытой папке, чтобы её свернуть.
- Если у папки нет подпапок, вместо стрелки показывается точка •.
- Нажмите на название папки (не на стрелку), чтобы выбрать папку и загрузить список её .md файлов.
3. Список файлов и открытие документа
В нижней части боковой панели отображается список .md файлов из выбранной папки.
Что показывается для каждого файла:
- Крупным текстом — заголовок документа (первый заголовок первого уровня # ... из файла). Заголовки загружаются в фоне после открытия папки.
- Мелким текстом — имя файла (например, api-reference.md).
Текущий открытый файл выделяется в списке.
4. Просмотр документа
Открытый документ отображается в области просмотра с полным Markdown-форматированием:
- Заголовки (#, ##, ###)
- Жирный текст (**текст**) и курсив (*текст*)
- Списки — маркированные и нумерованные
- Таблицы
- Блоки кода и inline code
- Горизонтальные разделители
- Цитаты (> текст)
- Картинки — отображаются, если файл изображения находится в той же папке, что и документ
- Ссылки — кликабельны
5. Масштаб картинок
В панели инструментов (над документом) есть поле «Масштаб для картинок» с числом в процентах.
Что это: позволяет уменьшить или увеличить все картинки в документе относительно их исходного размера.
- Диапазон: от 10% до 500%
- По умолчанию: 100% (исходный размер)
- Настройка сохраняется между сессиями (в localStorage браузера)
6. История навигации (кнопки ← и →)
В нижней панели кнопок (под документом) слева расположены две кнопки со стрелками — назад и вперёд.
Что это: история открытых документов, работает как кнопки «назад/вперёд» в браузере, но только для переходов между .md файлами внутри приложения.
Как работает:
- Каждый раз, когда вы открываете новый файл, он добавляется в историю.
- Кнопка ← активна, если есть предыдущий файл в истории.
- Кнопка → активна, если вы возвращались назад и можно идти вперёд.
- При переходе по истории приложение автоматически открывает нужную папку, если файл находится в другой папке.
- Если файл из истории был удалён, он пропускается, и история очищается для этой позиции.
В нижней панели кнопок (между стрелками и кнопкой «Добавить картинку») расположена кнопка «Исходник» / «Просмотр».
Что делает: переключает режим отображения текущего документа.
- Режим Просмотр (по умолчанию) — документ отображается с форматированием: заголовки, жирный текст, таблицы, картинки.
- Режим Исходник — документ отображается как чистый Markdown-текст, как он хранится в файле. Удобно для того, чтобы посмотреть или скопировать разметку.
В режиме Исходник кнопки вставки ссылок и картинок автоматически блокируются — редактирование доступно только в режиме Просмотр.
8. Вставка картинки в документ
Кнопка: «Добавить картинку» (иконка с горами).
Важно: картинки в документе отображаются только из той же папки, что и сам .md файл. Поэтому перед вставкой нужно загрузить изображение в ту же папку.
Как использовать:
- Откройте .md файл.
- Выделите текст в документе — любую фразу, после которой хотите вставить картинку.
- Нажмите «Добавить картинку».
- Откроется диалог со списком изображений из текущей папки (форматы: JPG, PNG, GIF, WebP, SVG, BMP, ICO, TIFF).
- Нажмите на нужный файл изображения.
- Картинка вставляется после строки, содержащей выделенный текст.
- Редактируемый документ автоматически сохраняется на диске Битрикс24.
Рекомендация: во избежание коллизий в ссылках на файлы избегайте названия, в которых используются символы, отличные от букв и цифр.

9. Вставка внутренней ссылки
Кнопка: «+ Внутренняя ссылка» (иконка документа).
Внутренняя ссылка — это ссылка с одного .md файла на другой .md файл, хранящийся на диске Битрикс24. При клике на такую ссылку в режиме просмотра приложение открывает целевой файл без перезагрузки страницы.
Как использовать:
- Откройте .md файл.
- Выделите текст в документе, который должен стать текстом ссылки.
- Нажмите «+ Внутренняя ссылка».
- Откроется диалог выбора файла с двумя колонками:
- Слева — список папок диска (только те, которые уже были открыты в текущей сессии). Нажмите на папку, чтобы загрузить её .md файлы.
- Справа — список .md файлов выбранной папки. Для каждого файла показывается заголовок и имя файла.
- Слева — список папок диска (только те, которые уже были открыты в текущей сессии). Нажмите на папку, чтобы загрузить её .md файлы.

Внешняя ссылка — это ссылка на любой URL в интернете. В режиме просмотра такие ссылки открываются в новой вкладке браузера.
Как использовать:
- Откройте .md файл.
- Выделите текст в документе, который должен стать текстом ссылки.
- Нажмите «+ Внешняя ссылка».
- Откроется диалог с полем ввода URL. Вверху будет показан выделенный вами текст.
- Введите URL (например, https://example.com) и нажмите «Вставить» или клавишу Enter.
- Ссылка вставляется под выделенный текст.
- Нажмите «Отмена» или клавишу Escape, чтобы закрыть диалог без изменений.
- Документ автоматически сохраняется.

- Внешние ссылки (начинаются с http:// или https://) — открываются в новой вкладке браузера.
- Внутренние ссылки на другие .md файлы — открываются прямо в приложении. Если файл находится в другой папке, папка переключается автоматически.
В нижней части боковой панели расположена кнопка «Загрузить файл».
Что делает: загружает файл с вашего компьютера в текущую выбранную папку на диске Битрикс24.
Как использовать:
- Выберите папку в дереве папок.
- Нажмите «Загрузить файл».
- Выберите файл на вашем компьютере.
- Файл загрузится в выбранную папку. После загрузки список файлов обновляется автоматически.
Это работает для любых файлов, не только .md. Таким образом можно загрузить картинки в папку, чтобы потом вставить их в документ.
Частые вопросы
- Картинка не отображается — показывается «Изображение не найдено» Убедитесь, что файл картинки находится в той же папке, что и открытый .md документ. Приложение ищет изображения только в текущей папке.
- Кнопки вставки ссылок и картинок неактивны Возможно, включён режим Исходник. Переключитесь обратно в режим Просмотр кнопкой в нижней панели.
- Нажал «+ Внутренняя ссылка», но в диалоге нет нужной папки В диалоге внутренних ссылок отображаются только папки, которые были открыты в текущей сессии. Сначала откройте нужную папку в боковой панели, затем вернитесь к документу и повторите вставку ссылки.
- Файл сохранился, но изменений не видно при следующем открытии Приложение кэширует содержимое файлов в памяти. При следующем открытии приложения (или при переключении хранилища) кэш сбрасывается и загружается актуальная версия.
- Статус показывает «Выделенный текст не найден в исходном файле» Это происходит, если выделенный текст не удалось найти в исходном Markdown. Попробуйте выделить другой фрагмент текста. Избегайте выделения текста, который содержит элементы из нескольких абзацев.