Cursor: примеры настроек, чистка Markdown и полезные приёмы

Cursor — редактор кода на базе VS Code с встроенным ИИ (чаты, автодополнение, правки по запросу). Чтобы эффективнее писать код и вести документацию, имеет смысл настроить окружение под себя и задать правила для проектов. В статье — примеры настроек Cursor, правила для чистки и единообразия Markdown (.md), настройка правил проекта, полезные приёмы и популярные советы с Reddit (r/cursor, r/CursorComposer и др.), плюс схемы: из чего состоит Cursor, когда использовать чат / Cmd+K / Composer и как устроена чистка .md.

Содержание

• Кратко: что такое Cursor
• Примеры настроек (settings.json)
• Правила проекта: .cursor/rules и .cursorrules
• Чистка и единообразие Markdown (.md)
• Полезные приёмы: Composer, Cmd+K, терминал
• Что советуют на Reddit и в сообществах
• Выводы

Кратко: что такое Cursor

Cursor — это форк VS Code с интеграцией ИИ: автодополнение в коде (Copilot++), чат с контекстом проекта, режим Composer (агент для правок в нескольких файлах) и быстрое редактирование по выделению (Cmd+K / Ctrl+K). Поддерживаются те же расширения и настройки, что и в VS Code, плюс свои опции для моделей и контекста. Схематично «слои» выглядят так:

Ниже — примеры настроек и правил, которые упростят работу с кодом и текстом.

Примеры настроек (settings.json)

Настройки Cursor хранятся в settings.json (Command Palette → «Preferences: Open User Settings (JSON)» или Ctrl+, и иконка «Open Settings (JSON)»). Пример блока полезных опций:

{
  "editor.fontSize": 14,
  "editor.tabSize": 4,
  "editor.insertSpaces": true,
  "editor.formatOnSave": true,
  "editor.rulers": [80, 120],
  "editor.wordWrap": "on",
  "files.trimTrailingWhitespace": true,
  "files.insertFinalNewline": true,
  "files.trimFinalNewlines": true,
  "[markdown]": {
    "editor.wordWrap": "on",
    "editor.quickSuggestions": {
      " other": true,
      " comments": true,
      " strings": true
    }
  }
}

Что даёт каждая настройка:

Для Markdown можно добавить своё поведение:

"[markdown]": {
  "editor.wordWrap": "on",
  "editor.wordWrapColumn": 100,
  "editor.quickSuggestions": { "other": true, "comments": true, "strings": true }
}

Так .md файлы будут с переносом строк и подсказками в тексте. Наглядно: что происходит при сохранении файла с включёнными опциями:

Правила проекта: .cursor/rules и .cursorrules

Cursor использует правила проекта, чтобы ИИ учитывал стиль кода, структуру и соглашения. Правила задают в:

• .cursor/rules/ — папка с файлами правил (например, general.mdc, markdown.mdc);
• .cursorrules в корне — один файл с общими правилами.

Пример .cursorrules для смешанного проекта (код + блог)

# Правила проекта

- Язык по умолчанию для ответов и комментариев в коде: русский, если не указано иное.
- Стиль кода: следовать уже принятому в проекте (отступы, кавычки, именование).
- При правке существующих файлов не менять стиль без явного запроса.
- Markdown: заголовки с # без лишних пробелов, списки с единообразными маркерами, таблицы выровнены.

Пример правила только для Markdown (.cursor/rules/markdown.mdc)

Создайте файл .cursor/rules/markdown.mdc:

---
description: Правила для редактирования Markdown в этом проекте
globs: ["**/*.md"]
---

# Markdown

- Заголовки: один пробел после #, без пробелов перед #. Уровни 1–6.
- Списки: единый стиль маркеров (- или *), отступ 2 или 4 пробела.
- Пустые строки: одна между блоками (заголовок, параграф, список), не более одной подряд в конце файла.
- Таблицы: выравнивание по разделителю |, пробелы вокруг ячеек по желанию, но единообразно.
- Код: инлайновый в `обратных кавычках`, блоки с указанием языка после ```.
- Не добавлять лишние пустые строки в начале или в конце файла.

Поле globs ограничивает действие правила только файлами *.md. Тогда при запросах вроде «приведи в порядок этот .md» или «почисти форматирование» модель будет опираться на эти правила. Структура правил в проекте:

Чистка и единообразие Markdown (.md)

Часто в .md накапливаются лишние переносы, разный стиль заголовков и списков. Ниже — типовые запросы к Cursor и что они делают.

Универсальный запрос на «приведение в порядок»

В чате или в Composer можно написать:

Приведи этот Markdown к единому стилю: убери лишние пустые строки (не более одной между блоками), приведи заголовки к формату «# Заголовок» без пробелов перед решёткой, списки оформи единообразно (маркер - и отступ 2 пробела), в конце файла одна пустая строка. Таблицы не трогай, если они уже выровнены.

Модель отредактирует открытый или выделенный файл по этим критериям.

Конкретные задачи

• Только пустые строки:
  «Удали лишние пустые строки: оставь максимум одну между параграфами/заголовками и одну в конце файла.»

• Заголовки:
  «Приведи все заголовки к виду: один пробел после #, без пробелов перед #, уровни H1–H6 без пропусков где нужно.»

• Списки:
  «Сделай все списки с маркером - и отступом 2 пробела для вложенных.»

• Trailing whitespace и конец файла:
  «Убери пробелы в конце строк и лишние пустые строки в конце файла.»

Если в проекте есть правило для Markdown (как выше в markdown.mdc), ответы будут стабильнее соответствовать вашему стилю.

Автоматизация через настройки

Часть «чистки» уже делают настройки из раздела выше:

• files.trimTrailingWhitespace: true — убирает пробелы в конце строк при сохранении.
• files.trimFinalNewlines: true — убирает лишние пустые строки в конце.
• files.insertFinalNewline: true — добавляет одну пустую строку в конец, если её нет.

Для глубокой правки структуры (заголовки, списки) по-прежнему удобнее один раз описать правило в .cursor/rules и периодически вызывать запрос «приведи в порядок этот .md». Цепочка «сырой» .md → настройки + запрос к ИИ → чистый результат:

Полезные приёмы: Composer, Cmd+K, терминал

• Composer (Cmd+I / Ctrl+I) — агент для задач по нескольким файлам. Удобно для рефакторинга, добавления фичи или массовой правки: откройте Composer, опишите задачу и при необходимости отметьте файлы через @. Для правки одного куска кода быстрее часто хватает Cmd+K.

• Cmd+K (Ctrl+K) — инлайновое редактирование по выделенному фрагменту. Выделите код или текст, нажмите Cmd+K, введите запрос (например: «переписать короче», «добавить проверку на null», «перевести на русский»). Изменения применяются сразу в редакторе.

• Чат с контекстом — в чате можно подключать файлы, папки и выбор через @. Удобно спрашивать «что делает этот файл» или «как лучше переименовать эту функцию во всех местах».

• Терминал — встроенный терминал (Ctrl+`) доступен и в Cursor. Запуск тестов, линтеров и скриптов не выходя из редактора экономит время.

• Rules for AI — правила из .cursor/rules и .cursorrules подхватываются автоматически. Имеет смысл завести хотя бы один общий файл и при необходимости отдельный для Markdown, как в примерах выше.

Когда что использовать:

Что советуют на Reddit и в сообществах

В сабреддитах вроде r/cursor, r/CursorComposer, а также в r/webdev и r/ProgrammingBuddies часто обсуждают, как выжать из Cursor максимум. Ниже — сводка популярных советов с Reddit, которые действительно упрощают жизнь.

• Писать правила в .cursorrules и .cursor/rules. Без явных правил модель не знает стиль проекта и может предлагать лишнее или не в том формате. Один файл в корне с языком, отступами и соглашениями по именованию уже сильно улучшает ответы. Для разных типов файлов (например, только .md) — отдельные .mdc с globs. На Reddit это один из самых частых советов новичкам.

• Использовать @ при каждом запросе. В чате и в Composer можно подключать контекст через @: файл (@filename), папка (@folder), выделенный код. Если не указать файлы, модель опирается на общий контекст и может «галлюцинировать» структуру. Формулировка в духе: «вот этот файл @src/api.js — добавь валидацию» даёт стабильнее результат. Пользователи на Reddit подчёркивают: «всегда тащи в контекст то, что правишь».

• Не тащить в контекст лишнее. Огромный контекст (весь репозиторий или десятки файлов) размывает фокус и съедает лимиты. Лучше явно указать 2–5 релевантных файлов или одну папку. Совет с Reddit: «добавляй только то, что нужно для задачи».

• Для точечных правок — Cmd+K, для мультифайла — Composer. Многие пишут, что по привычке открывают чат для всего подряд, но быстрее бывает: выделил кусок → Cmd+K → короткий запрос. Рефакторинг по нескольким файлам, новая фича с созданием/изменением многих мест — в Composer с чётким описанием задачи и при необходимости @ на папки.

• Проверять diff перед Accept. Cursor предлагает изменения блоками; перед «Accept» стоит пробежаться по diff. Иногда модель добавляет лишние импорты, дублирует код или меняет то, что не просили. Привычка «посмотрел — принял» экономит время на откатах и ревью.

• Настроить модель и контекст под задачу. В настройках Cursor можно выбрать модель (в том числе быструю для автодополнения и более умную для чата/Composer). Для рутинного кода иногда хватает быстрой; для сложной логики и архитектуры — более мощной. На Reddit советуют не держать одну модель «на всё», а подстраивать под тип задачи.

• Держать правила и сниппеты в репозитории. Если в проекте есть .cursorrules и, при необходимости, сниппеты или примеры в .cursor/rules, любой в команде (или вы на другой машине) получает тот же контекст для ИИ. Это особенно ценно для единообразия стиля и онбординга — об этом часто говорят в обсуждениях «как настроить Cursor в команде».

Сводно эти советы можно представить так:

Выводы

• Настройки Cursor совместимы с VS Code: settings.json, editor.formatOnSave, files.trimTrailingWhitespace, files.insertFinalNewline, files.trimFinalNewlines помогают держать код и .md в порядке при сохранении.

• Правила проекта в .cursor/rules/ и .cursorrules задают стиль и соглашения; правило с globs: ["**/*.md"] — хорошая база для единообразного Markdown.

• Чистка .md: один раз описать желаемый стиль в правиле и использовать запросы вроде «приведи этот Markdown к единому стилю» или «убери лишние пустые строки»; часть работы делают настройки trim и final newline.

• Composer и Cmd+K — основные инструменты для правок с ИИ: Composer для многофайловых задач, Cmd+K для быстрых правок по выделению.

• Советы с Reddit: писать правила в .cursorrules, использовать @ для контекста, не тащить лишнее, проверять diff перед Accept и держать правила в репозитории — всё это часто рекомендуют в r/cursor и смежных сообществах.

Эти примеры настроек, правил и советов можно скопировать и подстроить под свой проект — так Cursor станет удобнее и для кода, и для документации в Markdown.