Многие компании в России столкнулись с ситуацией, когда привычные облачные сервисы прекратили работу, а данные оказались заперты в проприетарных форматах, которые без специальных инструментов не открыть.

Концепция «Файл вместо приложения», предложенная Стефаном Ангом, сооснователем Obsidian, предлагает решение: переместить фокус с инструментов на данные, обеспечив их доступность, долговечность и независимость от конкретного ПО.

Всем привет! Меня зовут Катя, я развиваю Open Source-платформу Gramax для управления технической документацией. В этой статье хочу обсудить, почему подход «Файл вместо приложения» набирает популярность, какие преимущества приносит бизнесу, а также как мы реализуем его в Gramax.

Почему концепция набирает популярность

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

  • Контроль над данными. Пользователи и компании хотят владеть своей информацией, а не зависеть от сторонних платформ. Локальное хранение исключает риск потери данных из-за внешних факторов.

  • Долговечность. Программное обеспечение устаревает, теряет поддержку или не работает на новых устройствах. Файлы в открытых форматах, таких как Markdown, читаемы десятилетиями, если хранятся локально или в управляемых репозиториях.

  • Совместимость. Данные в универсальных форматах (Markdown, JSON, CSV) открываются множеством инструментов, снижая зависимость от одного приложения.

  • Независимость от облака. Облачные сервисы требуют постоянного интернета и доверия к провайдеру. Локальные решения работают всегда, даже если сервера «легли» (а они любят это делать в самый неподходящий момент).

  • Рост Open Source. По данным GitHub Octoverse 2024, активность в Open Source проектах выросла на 60%, включая создание 70,000 новых публичных и Open Source AI-проектов. Это отражает спрос на автономные решения.

Популярность открытых форматов также подтверждается данными Stack Overflow Developer Survey 2024, где 29.1% разработчиков используют Markdown как асинхронный инструмент. Это подчеркивает, что Markdown становится стандартом для документации благодаря своей простоте и совместимости.

Почему бизнес выбирает self-hosted решения

Для IT-компаний концепция «Файл вместо приложения» — стратегический выбор. Основные причины:

  • Безопасность и конфиденциальность. Ужесточение законодательства, такого как ФЗ-152 в России или GDPR в Европе, требует минимизации передачи данных сторонним провайдерам. Выбирая self-hosted решения, бизнес контролирует, где физически хранятся данные, кто имеет к ним доступ и как они обрабатываются. Это снижает юридические риски и упрощает соответствие требованиям регуляторов.

  • Надежность. Локальные решения не зависят от внешних серверов, что критично для компаний с высокими требованиями к доступности. Self-hosted решение — это возможность контролировать отказоустойчивость и бэкапы без ожидания от внешнего вендора.

  • Гибкость. Self-hosted инструменты можно адаптировать под свои процессы: от интеграции с CI/CD до кастомных шаблонов. Такой подход, как правило, невозможен в закрытых SaaS-сервисах.

  • Независимость от вендора. Данные в открытых форматах позволяют мигрировать на другие платформы без потерь, устраняя риск vendor lock-in. Независимость — это свобода менять инструменты без страха потерять данные или тратить месяцы на миграцию. А значит, можно гибко менять архитектуру, не рискуя стабильностью или совместимостью.

Как мы это делаем в Gramax

Gramax — платформа для подготовки технической документации на базе подхода Docs as Code. В отличие от традиционных облачных сервисов (таких как Confluence, Notion или Google Docs), Gramax хранит текст в обычном Markdown, а версионирует его с помощью Git.

Локальное хранение в Markdown

В Gramax документация пишется в удобном визуальном редакторе, а сохраняется в Markdown-файлах. Они существуют локально на компьютере редактора или в Git-репозитории.

  • Долговечность. Markdown — открытый формат, читаемый любым редактором, от Notepad до VS Code. Через 20 лет твои данные не превратятся в «цифровую археологию».

  • Совместимость. Статьи открываются в Obsidian, Zettlr или обрабатываются скриптами (например, для анализа метаданных в Python).

  • Контроль. Данные принадлежат команде или компании, без зависимости от облачных провайдеров.

Markdown, конечно, не дает всей гибкости оформления сложных таблиц или ярких визуальных блоков ?

В Gramax мы расширяем его синтаксис — добавляем кастомные элементы для свободы оформления. Но также лояльно относимся к выбору других нотаций: например, можем хранить исходники в MDX и GitHub Flavored Markdown.

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

Интеграция с Git

Gramax использует Git для синхронизации и версионирования. Можно подключить GitHub, GitLab, Bitbucket, Gitea или любого другого провайдера.

  • Версионирование. Все правки фиксируются в Git. Ошибся? Откатывай. Нужен ревью? Делай запрос слияния.

  • Self-hosted. Портал документации разворачивается на своем сервере в виде статического сайта или Docker-контейнера. Никаких внешних зависимостей.

  • Коллаборация. Разработчики работают с Markdown в VS Code, аналитики — через интерфейс Gramax. Все изменения синхронизируются через Git.

Поддержка миграции

Gramax, ко всему прочему, делает упор на экспорт и переносимость данных:

  • Универсальный формат. Markdown-файлы легко экспортируются и импортируются в другие системы, что минимизирует риск vendor lock-in.

  • Экспорт в популярные форматы. DOCX и PDF на случай, если партнеры или заказчики не поддерживают «модное».

  • Импорт из популярных систем. Gramax помогает «вытащить» контент из Confluence, Notion и Yandex Wiki в Markdown. После импорта не обязательно использовать Gramax: можно просто сохранить все файлы в репозитории и просматривать в исходниках.

  • Простота перехода. Данные, хранящиеся в Git, можно перенести в другую систему, просто скопировав репозиторий, или использовать API для автоматизации миграции.

Предвосхищаем комментарий: «Gramax — коробка, это уже vendor lock» ?

Любую систему, на которую компания не имеет прав, можно охарактеризовать как vendor lock. Исходный код Gramax выложен в открытый доступ под лицензией GPL-3.0 license. Это означает, что Gramax можно дорабатывать под свои задачи.

Также в ближайшее время в Gramax появится механизм модулей — достаточно будет написать необходимую возможность и подключить ее в виде дополнительного модуля.

Инструменты для команд

Gramax предлагает функциональность, ориентированную на IT-команды, сохраняя при этом принципы «Файл вместо приложения»:

  • Шаблоны. Централизованные шаблоны в Git-репозитории упрощают создание однотипных документов (технических заданий, отчетов), сохраняя их в Markdown.

  • Свойства (properties). Метаданные для структурирования статей (например, статус задачи, дедлайн) хранятся в Markdown, что позволяет фильтровать и анализировать данные без привязки к платформе.

  • Интерактивные диаграммы. Поддержка визуальных редакторов для диаграмм снижает барьер для участников команды, не знакомых с синтаксисом Mermaid или PlantUML.

Если вы посчитали статью рекламой и приготовили минусомет ?

Как мы писали в статье «От Docs as Code к Everything as Code: как Gramax меняет работу с документацией» — у нас есть концептуальная идея о том, что мы можем сделать работу многих команд удобнее и легче.

Потому мы выложили Gramax в Open Source. При этом никак не отслеживаем (и не можем это сделать) использование Gramax.

Безопасность и автономия

Gramax не использует облачные бэкенды, что идеально для компаний с высокими требованиями к безопасности. Развертывание на своем сервере и хранение в Git соответствуют ФЗ-152 и GDPR.

Так чего, микротренд или..?

В России концепция «Файл вместо приложения» особенно актуальна из-за локальных реалий:

  • Санкции и уход вендоров. Закрытие доступа к некоторым облачным сервисам (например, Microsoft 365, Google Workspace) подтолкнуло компании к поиску self-hosted решений.

  • Законодательство. ФЗ-152 и требования к локализации данных заставляют бизнес искать инструменты, которые можно развернуть на своих серверах.

  • Open Source культура. Российские IT-команды активно используют Open Source инструменты, что делает Gramax и подобные решения привлекательными.

На глобальном уровне концепция «Файл вместо приложения» также набирает обороты:

  • Рост Open Source. Инструменты вроде Obsidian, Logseq и Zettlr показывают, что пользователи ценят независимость данных. Gramax вписывается в этот тренд, предлагая командную версию такого подхода.

  • Data sovereignty. В Европе (GDPR), США (HIPAA) и других регионах требования к конфиденциальности данных усиливают спрос на локальные и переносимые решения.

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

Прочитать полную цитату можно здесь.


Открыто, бесплатно, и с сообществом

Комментарии (6)


  1. outlingo
    08.07.2025 09:14

    За осознание правильности концепции "плюс" а за голимый LLM-ный маркетвыхлоп "минус"


    1. krakenkaken Автор
      08.07.2025 09:14

      Даже не знаю, радоваться или грустить...

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

      Как пруф могу показать промежуточные версии:

      Ой, это же Gramax: сравнение версий
      Ой, это же Gramax: сравнение версий

      Помогите сделать работу над ошибками: как думаете, что убрать, что добавить?


  1. dyadyaSerezha
    08.07.2025 09:14

    Только ближе к концу статьи написано, что же предлагает Gramax как платформа. А до этого - читаешь и не можешь понять: ну markdown, ну git, ну локальный репозиторий с документами, ну текстовые редакторы. Так это всё я и так имею или могу сделать. А что мне Gramax даёт? Непонятно. Потом, наконец, прояснилось, что есть экспорт/импорт и метаполя. Это всё? Ну допустим, все. Но с этого и надо начинать - с того, что даёт ваш продукт сверху к "git + редакторы". А то много слов вокруг да около, но ничего толком не понятно.


    1. krakenkaken Автор
      08.07.2025 09:14

      Для этой статьи выбрали категорию "Мнение", чтобы поразмышлять о концепции и ее профитах. И рассказать про Gramax ТОЛЬКО с точки зрения концепции.

      Про сам Gramax писали в других статьях, например:

      Ну и всегда рады поболтать в комментариях или личных сообщениях:)


      1. dyadyaSerezha
        08.07.2025 09:14

        Спасибо, но эти ссылки лучше дать сразу после заголовка "Как мы это делаем в Gramax".


  1. Sazonov
    08.07.2025 09:14

    У вас свой шаблонизатор или что-то готовое используете типа hugo?