1 files changed, 101 insertions, 0 deletions
diff --git a/config/nvim/lua/keymaps_documentation.md b/config/nvim/lua/keymaps_documentation.md
new file mode 100644
index 0000000..4a7f874
--- /dev/null
+++ b/config/nvim/lua/keymaps_documentation.md
@@ -0,0 +1,101 @@
+# Описание клавиатурных сокращений Neovim
+
+Данный документ содержит описание всех клавиатурных сокращений, настроенных в `keymaps.lua`, сгруппированных по категориям.
+
+---
+
+## Базовая навигация
+
+- `<Space>` → Ничего не делает (отключено в нормальном режиме)
+- `<Home>` → Переход к первому непустому символу строки (в нормальном режиме)
+- `<End>` → Переход к концу строки (в нормальном режиме)
+- `<Home>` → Переход к первому непустому символу строки (в визуальном режиме)
+- `<End>` → Переход к концу строки (в визуальном режиме)
+- `<Home>` → Переход к первому непустому символу строки (в режиме вставки)
+- `<End>` → Переход к концу строки (в режиме вставки)
+
+## Визуальный режим
+
+- `i` → Выделить внутреннюю часть объекта (аналог `inner` в визуальном режиме)
+- `a` → Выделить объект целиком (`around` в визуальном режиме)
+- `J` → Переместить выделенный фрагмент вниз
+- `K` → Переместить выделенный фрагмент вверх
+- `<` → Уменьшить отступ выделения и сохранить выделение
+- `>` → Увеличить отступ выделения и сохранить выделение
+
+## Управление буферами
+
+- `<leader>bn` → Следующий буфер
+- `<leader>bp` → Предыдущий буфер
+- `<leader>bd` → Удалить текущий буфер
+- `<C-s>` → Сохранить все файлы
+- `<leader>q` → Закрыть текущее окно/буфер
+- `<leader>vs` → Вертикальное разделение окна
+
+## Управление вкладками
+
+- `<A-Right>` → Следующая вкладка
+- `<A-Left>` → Предыдущая вкладка
+- `<A-t>` → Новая вкладка
+- `<A-w>` → Закрыть текущую вкладку
+- `<A-1>` до `<A-9>` → Переход к вкладке по номеру (1–9)
+
+## Файловый эксплорер (nvim-tree)
+
+- `<C-c>` → Сменить корень проводника на текущий рабочий каталог
+- `<F3>` → Показать/скрыть файловый проводник
+
+## Поиск (Telescope)
+
+- `<leader>ff` → Поиск файлов
+- `<leader>fg` → Поиск по содержимому файлов (live grep)
+- `<leader>fb` → Поиск в текущем файле
+- `<F4>` → Поиск среди открытых буферов
+- `<leader>gc` → Просмотр истории коммитов Git
+- `<leader>gs` → Просмотр статуса Git
+- `<leader>ch` → История команд
+- `<leader>e` → Просмотр диагностических сообщений
+- `gi` → Поиск реализаций LSP
+- `gr` → Поиск ссылок (references) в LSP
+
+## LSP (Языковой сервер)
+
+- `d[` → Переход к предыдущей диагностике
+- `d]` → Переход к следующей диагностике
+- `gD` → Переход к объявлению (declaration)
+- `gd` → Переход к определению (definition)
+- `K` → Показать документацию (hover)
+- `<C-k>` → Подсказка по сигнатуре функции
+- `<leader>sad` → Поиск в API-документации
+- `<leader>wa` → Добавить папку в рабочую область
+- `<leader>wr` → Удалить папку из рабочей области
+- `<leader>im` → Сгенерировать реализацию интерфейса (для Go)
+- `<leader>wl` → Вывести список рабочих папок
+- `<A-CR>` → Выполнить действие кода (code action)
+- `<F2>` → Переименовать символ
+- `<A-q>` → Перенести длинные строки (reflow)
+
+## Изменение размера окон
+
+- `<C-A-Left>` → Уменьшить ширину окна слева
+- `<C-A-Right>` → Увеличить ширину окна справа
+- `<C-A-Up>` → Уменьшить высоту окна сверху
+- `<C-A-Down>` → Увеличить высоту окна снизу
+
+## Отладка (DAP)
+
+- `<F6>` → Показать/скрыть интерфейс отладки
+- `<Leader>dh` → Подсказка при отладке (hover)
+- `<Leader>dp` → Предварительный просмотр при отладке
+- `<F9>` → Открыть области видимости в центре экрана
+- `<F5>` → Продолжить выполнение
+- `<S-F5>` → Перезапустить отладку
+- `<C-F5>` → Остановить отладку
+- `<F8>` → Шаг с обходом (step over)
+- `<F7>` → Шаг с заходом (step into)
+- `<S-F7>` → Шаг с выходом (step out)
+- `<A-b>` → Установить/удалить точку останова
+
+## Форматирование
+
+- `<leader>mp` → Отформатировать файл или выделенный диапазон