Вы установили плагин для QuickLook, чтобы просматривать Markdown-файлы с подсветкой синтаксиса, но macOS упорно открывает их через Xcode, показывая обычный текст? Это распространённая проблема, особенно после обновлений системы. Давайте разберёмся, как заставить macOS «забыть» о Xcode и использовать ваш плагин.
Почему QuickLook игнорирует QLMarkdown?
Первое, что стоит проверить – корректность установки плагина. Многие пользователи забывают, что файлы расширений QuickLook должны находиться в папке ~/Library/QuickLook (для текущего пользователя) или /Library/QuickLook (для всех). Если вы скопировали QLMarkdown.qlgenerator в другую директорию, macOS его просто не увидит. Загляните в терминал:
ls -la ~/Library/QuickLook/QLMarkdown.qlgeneratorЕсли путь не существует – переустановите плагин, используя официальный .dmg-файл или через Homebrew (brew install qlmarkdown). После этого выполните:
qlmanage -r && qlmanage -r cacheЭто перезагрузит службу QuickLook и очистит кеш. Если проблема осталась, возможно, ваш плагин устарел (особенно актуально для macOS Sequoia и новее). Например, QLMarkdown последний раз обновлялся в 2018 году – на новых системах он может работать некорректно.
Проверьте версию macOS в терминале:
sw_vers -productVersion. Если у вас 14.x (Sonoma/Sequoia) – стоит рассмотреть альтернативы.
Markdown Preview: безопасная замена через App Store
Если QLMarkdown не запускается или вызывает ошибки безопасности (как в случае с предупреждением о «ненадёжном приложении»), попробуйте официальное решение из App Store. Например, Markdown Preview – это проверенное расширение, которое:
- не требует отключения SIP (System Integrity Protection);
- работает через стандартный механизм расширений macOS;
- поддерживает подсветку синтаксиса и тёмную тему.
После установки:
- Откройте Системные настройки → Общие → Расширения.
- В разделе QuickLook найдите Markdown Preview и активируйте переключатель.
- Нажмите ⓘ рядом с названием, чтобы проверить разрешения (должен быть доступ к файлам и папкам).
Если QuickLook по-прежнему открывает .md через Xcode, попробуйте вручную сменить ассоциацию файлов:
- Выберите любой .md-файл в Finder.
- Нажмите Cmd + I (Свойства).
- В разделе «Открывать в» выберите TextEdit или другой текстовый редактор.
- Нажмите «Изменить всё…» и подтвердите.
Это «обнулит» привязку к Xcode, после чего QuickLook должен переключиться на ваш плагин.
Ошибка «Apple не может проверить на наличие вредоносного ПО»
Эта проблема возникает со сторонними приложениями, не подписанными Apple. Чтобы обойти блокировку:
- Для разовой установки: в Finder нажмите ПКМ на .app-файл → «Открыть», затем «Всё равно открыть» в диалоговом окне.
- Для постоянного использования: перейдите в Системные настройки → Конфиденциальность и безопасность → Безопасность и разрешите запуск приложения в разделе «Разрешено программное обеспечение».
Если опция «Всё равно открыть» недоступна, выполните в терминале:
sudo xattr -rd com.apple.quarantine /Path/To/QLMarkdown.appЭто удалит карантинный атрибут, который macOS добавляет для непроверенных файлов.
Важно:
не отключайте Gatekeeper полностью (sudo spctl --master-disable) – это сделает систему уязвимой. Лучше потратить минуту на ручное разрешение, чем рисковать безопасностью.
Дополнительные советы
Если ни один метод не сработал, проверьте:
- Не установлен ли параллельно другой плагин для Markdown (например, от GitHub Desktop) – они могут конфликтовать.
- Не блокирует ли антивирус или фаервол запуск расширений (временное отключение поможет это выяснить).
- Есть ли обновления для вашего плагина – некоторые разработчики выпускают патчи для новых версий macOS.
Для продвинутых пользователей: можно вручную удалить связь .md с Xcode через терминал:
duti -s com.apple.dt.Xcode public.text allНо это рискованный метод – лучше использовать графические инструменты вроде SwiftDefaultApps, которые безопаснее меняют ассоциации файлов.