Для организации работы всей компании
Помогает продавать больше
Легко настроить без программирования
Создание в простом конструкторе с AI-помощником. Интегрировано в CRM
Документы MD
Доступно в подписке

Документы MD

Читаем и редактируем Markdown-файлы прямо в Битрикс24

Описание
Документы MD — это приложение, которое позволяет просматривать документацию, инструкции и базу знаний, хранимую на дисках Битрикс24 в формате "маркдаун", и удобно читать её с красивым форматированием прямо внутри портала.

Вместо того чтобы хранить документы в Word или Google Docs, вы пишете их в формате .md (Markdown) — простом текстовом формате с заголовками, списками, таблицами, кодом и ссылками. Приложение отображает эти файлы как красиво отформатированные страницы, и позволяет редактировать ссылки и вставлять картинки прямо из браузера, без скачивания файлов.
Данный формат сейчас становится популярным.

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

Экран разделён на три части:
Разделитель между боковой панелью и областью просмотра можно перетащить — изменить ширину боковой панели. Разделитель между деревом папок и списком файлов тоже можно перетащить — изменить, сколько места занимает каждая секция.



Все возможности приложения

1. Выбор хранилища
В верхней части боковой панели находится кнопка с иконкой меню и названием текущего хранилища.
Что это даёт: в Битрикс24 может быть несколько дисков — Общий диск, Личный диск, диски рабочих групп. Приложение показывает все диски, к которым у вас есть доступ, и вы можете переключаться между ними.
Как использовать: нажмите на кнопку хранилища — откроется выпадающий список. Выберите нужный диск. Приложение перезагрузит дерево папок для выбранного диска.
При открытии приложение автоматически открывает Общий диск.

2. Навигация по папкам

В верхней части боковой панели отображается дерево папок текущего хранилища.
Как работает:
  • Папки с вложенными подпапками имеют стрелку ▸ слева — нажмите её, чтобы раскрыть подпапки.
  • Нажмите ▾ на раскрытой папке, чтобы её свернуть.
  • Если у папки нет подпапок, вместо стрелки показывается точка •.
  • Нажмите на название папки (не на стрелку), чтобы выбрать папку и загрузить список её .md файлов.
Когда папка выбрана, её название выделяется, а в нижней части боковой панели появляется список .md файлов из этой папки.

3. Список файлов и открытие документа

В нижней части боковой панели отображается список .md файлов из выбранной папки.

Что показывается для каждого файла:
  • Крупным текстом — заголовок документа (первый заголовок первого уровня # ... из файла). Заголовки загружаются в фоне после открытия папки.
  • Мелким текстом — имя файла (например, api-reference.md).
Как открыть: нажмите на любой файл в списке. Документ загрузится и отобразится в области просмотра справа.
Текущий открытый файл выделяется в списке.

4. Просмотр документа

Открытый документ отображается в области просмотра с полным Markdown-форматированием:
  • Заголовки (#, ##, ###)
  • Жирный текст (**текст**) и курсив (*текст*)
  • Списки — маркированные и нумерованные
  • Таблицы
  • Блоки кода и inline code
  • Горизонтальные разделители
  • Цитаты (> текст)
  • Картинки — отображаются, если файл изображения находится в той же папке, что и документ
  • Ссылки — кликабельны
В строке статуса (правый верхний угол области просмотра) показывается дата последнего изменения открытого файла.

5. Масштаб картинок

В панели инструментов (над документом) есть поле «Масштаб для картинок» с числом в процентах.
Что это: позволяет уменьшить или увеличить все картинки в документе относительно их исходного размера.
  • Диапазон: от 10% до 500%
  • По умолчанию: 100% (исходный размер)
  • Настройка сохраняется между сессиями (в localStorage браузера)
Как использовать: введите нужное значение или измените число. Картинки в документе масштабируются немедленно.

6. История навигации (кнопки ← и →)

В нижней панели кнопок (под документом) слева расположены две кнопки со стрелками — назад и вперёд.
Что это: история открытых документов, работает как кнопки «назад/вперёд» в браузере, но только для переходов между .md файлами внутри приложения.
Как работает:
  • Каждый раз, когда вы открываете новый файл, он добавляется в историю.
  • Кнопка ← активна, если есть предыдущий файл в истории.
  • Кнопка → активна, если вы возвращались назад и можно идти вперёд.
  • При переходе по истории приложение автоматически открывает нужную папку, если файл находится в другой папке.
  • Если файл из истории был удалён, он пропускается, и история очищается для этой позиции.
7. Переключение режима: Просмотр / Исходник
В нижней панели кнопок (между стрелками и кнопкой «Добавить картинку») расположена кнопка «Исходник» / «Просмотр».
Что делает: переключает режим отображения текущего документа.
  • Режим Просмотр (по умолчанию) — документ отображается с форматированием: заголовки, жирный текст, таблицы, картинки.
  • Режим Исходник — документ отображается как чистый Markdown-текст, как он хранится в файле. Удобно для того, чтобы посмотреть или скопировать разметку.
Кнопка всегда показывает название следующего режима (т.е. куда вы переключитесь при нажатии).
В режиме Исходник кнопки вставки ссылок и картинок автоматически блокируются — редактирование доступно только в режиме Просмотр.

8. Вставка картинки в документ

Кнопка: «Добавить картинку» (иконка с горами).
Важно: картинки в документе отображаются только из той же папки, что и сам .md файл. Поэтому перед вставкой нужно загрузить изображение в ту же папку.
Как использовать:
  1. Откройте .md файл.
  2. Выделите текст в документе — любую фразу, после которой хотите вставить картинку.
  3. Нажмите «Добавить картинку».
  4. Откроется диалог со списком изображений из текущей папки (форматы: JPG, PNG, GIF, WebP, SVG, BMP, ICO, TIFF).
  5. Нажмите на нужный файл изображения.
  6. Картинка вставляется после строки, содержащей выделенный текст.
  7. Редактируемый документ автоматически сохраняется на диске Битрикс24.
Важно: вы можете добавлять картинки только из той же папки, где хранится просматриваемый документ.
Рекомендация: во избежание коллизий в ссылках на файлы избегайте названия, в которых используются символы, отличные от букв и цифр.



9. Вставка внутренней ссылки

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

  • 10. Вставка внешней ссылки
  • Кнопка: «+ Внешняя ссылка» (иконка цепочки).
    Внешняя ссылка — это ссылка на любой URL в интернете. В режиме просмотра такие ссылки открываются в новой вкладке браузера.
    Как использовать:
    1. Откройте .md файл.
    2. Выделите текст в документе, который должен стать текстом ссылки.
    3. Нажмите «+ Внешняя ссылка».
    4. Откроется диалог с полем ввода URL. Вверху будет показан выделенный вами текст.
    5. Введите URL (например, https://example.com) и нажмите «Вставить» или клавишу Enter.
    6. Ссылка вставляется под выделенный текст.
    7. Нажмите «Отмена» или клавишу Escape, чтобы закрыть диалог без изменений.
    8. Документ автоматически сохраняется.
    11. Клики по ссылкам в документе
    • Внешние ссылки (начинаются с http:// или https://) — открываются в новой вкладке браузера.
    • Внутренние ссылки на другие .md файлы — открываются прямо в приложении. Если файл находится в другой папке, папка переключается автоматически.
    12. Загрузка файлов на диск
    В нижней части боковой панели расположена кнопка «Загрузить файл».
    Что делает: загружает файл с вашего компьютера в текущую выбранную папку на диске Битрикс24.
    Как использовать:
    1. Выберите папку в дереве папок.
    2. Нажмите «Загрузить файл».
    3. Выберите файл на вашем компьютере.
    4. Файл загрузится в выбранную папку. После загрузки список файлов обновляется автоматически.
    Во время загрузки кнопка неактивна и показывает текст «Загрузка…».
    Это работает для любых файлов, не только .md. Таким образом можно загрузить картинки в папку, чтобы потом вставить их в документ.

    Частые вопросы
    • Картинка не отображается — показывается «Изображение не найдено» Убедитесь, что файл картинки находится в той же папке, что и открытый .md документ. Приложение ищет изображения только в текущей папке.
    • Кнопки вставки ссылок и картинок неактивны Возможно, включён режим Исходник. Переключитесь обратно в режим Просмотр кнопкой в нижней панели.
    • Нажал «+ Внутренняя ссылка», но в диалоге нет нужной папки В диалоге внутренних ссылок отображаются только папки, которые были открыты в текущей сессии. Сначала откройте нужную папку в боковой панели, затем вернитесь к документу и повторите вставку ссылки.
    • Файл сохранился, но изменений не видно при следующем открытии Приложение кэширует содержимое файлов в памяти. При следующем открытии приложения (или при переключении хранилища) кэш сбрасывается и загружается актуальная версия.
    • Статус показывает «Выделенный текст не найден в исходном файле» Это происходит, если выделенный текст не удалось найти в исходном Markdown. Попробуйте выделить другой фрагмент текста. Избегайте выделения текста, который содержит элементы из нескольких абзацев.
  • Рейтинг
    0 /5
    5 звезд
    0
    4 звезды
    0
    3 звезды
    0
    2 звезды
    0
    1 звезда
    0
    Отзывы
    Отзывы отсутствуют!

    Другие приложения разработчика

    Мои документы Подписка

    Инструмент для управления корпоративным документооборотом.

    (6)
    (1583)
    Календарь бронирования Подписка

    Удобная шахматка для записи клиентов в CRM.

    (2)
    (2358)
    Нумератор в CRM Подписка

    Автоматическая генерация уникальных номеров в CRM

    (3)
    (138)
    Маркеры в CRM Подписка

    Добавьте цветные маркеры в любые сущности CRM!

    (3)
    (129)
    Управление производством и работами Подписка

    Позволяет подключить к процессу управления стадиями (этапами) производства продукции работников цеха (или любых подразделений на производстве) без авторизации в CRM Битрикс24. Также приложение можно использовать для любых работ, выполняемых на территории заказчика - монтаж, установка, настройка, клининг и т.п.

    (1)
    (168)
    Личный кабинет клиента Подписка

    Просмотр клиентами заказов и согласование стадий!

    (0)
    (159)
    Синхронизация сделок и заказов в 1С:Предприятие 8 Подписка

    Заказ клиента на стороне 1С на основании сделок в Битрикс24.

    (0)
    (131)
    Комплекты товаров Подписка

    Добавляй готовые наборы товаров в сделку быстро, без ошибок.

    (1)
    (26)
    Мои чаты Подписка

    Удобный интерфейс для чатов открытых линий, группировка

    (0)
    (21)
    Геотаргетинг (чек-ин) для CRM + чат-бот Подписка

    Фиксация позиции GPS по адресам клиентов из CRM.

    (0)
    (350)