xykong /
flux-markdown
Улучшенный предпросмотр Markdown для macOS QuickLook. Быстрый просмотр файлов через пробел с поддержкой рендеринга.
Форки
28
Звёзды
1.0k
Issues
0
flux-markdown добавляет полноценный рендеринг Markdown в QuickLook на macOS. Нажимай пробел — получай красивый предпросмотр вместо сырого текста.
Что делает
Этот плагин превращает стандартный системный предпросмотр файлов в macOS в полноценный markdown-вьюер. Теперь тебе не нужно открывать тяжелые редакторы типа Obsidian или VS Code, чтобы просто быстро глянуть содержимое документа.
Он подхватывает файлы с расширением .md и отображает их с нормальной версткой прямо в Finder. Это экономит кучу времени при работе с документацией или заметками.
Как работает
Инструмент использует нативные возможности QuickLook для macOS. Он перехватывает запрос системы на отображение файла и подменяет стандартный текстовый вывод на отрендеренную HTML-страницу.
Вся магия происходит на уровне системного плагина. Он не требует запуска фоновых процессов или тяжелых фреймворков.
Кому подходит
Вайб-кодерам, которые хранят документацию к своим SaaS-проектам в локальных папках.
Тем, кто постоянно путается в куче .md файлов и хочет быстро находить нужную информацию.
Пользователям macOS, которые ценят чистоту рабочего пространства и не хотят держать открытыми лишние окна редакторов.
Основные возможности
Рендеринг Markdown-файлов внутри системного окна QuickLook.
Поддержка нативной интеграции с Finder через пробел.
Минималистичный интерфейс без лишних панелей управления.
Быстрая работа за счет использования системных API Apple.
Как установить
Скачай последнюю версию архива из репозитория GitHub. Распакуй его и перенеси файл плагина в системную директорию.
mv FluxMarkdown.qlgenerator ~/Library/QuickLook/
qlmanage -rПосле этого перезапусти Finder или просто нажми пробел на любом .md файле.
Как применить в своём продукте
Используй это как часть своего локального стека разработки. Если ты создаешь контентный проект, где много текстовых файлов, такой быстрый просмотр ускорит работу с базой знаний.
Интегрируй в свой workflow по написанию документации для SaaS.
Используй для быстрой проверки сгенерированных AI-отчетов в формате Markdown.
Настрой быстрый доступ к логам, которые ты пишешь в формате заметок.
Подводные камни
Плагин работает только на macOS. Если ты перейдешь на Windows или Linux, функционал пропадет. Также он не поддерживает сложные скрипты внутри Markdown — только стандартную разметку.
Частые вопросы
Нужно ли постоянно обновлять плагин?
Нет, он работает на базе системных API. Обновления требуются только при выходе критических изменений в macOS, которые ломают работу QuickLook.
Можно ли настроить тему оформления?
На данный момент плагин использует стандартные стили. Он ориентирован на скорость и простоту, поэтому глубокая кастомизация интерфейса не предусмотрена.
Будет ли он работать с другими расширениями, например .markdown?
Обычно QuickLook подхватывает стандартные расширения. Если файл не отображается, убедись, что система распознает его как текстовый документ.
Похожие репозитории
IINA — это мощный видеоплеер для macOS на базе MPV. Идеальное решение, если нужно встроить качественный медиа-движок в свой проект или просто заменить стандартные плееры.
Stats — это open source монитор ресурсов для macOS, который живет в строке меню. Показывает всё: от нагрузки на CPU до температуры датчиков и скорости сети.
UTM запускает Windows, Linux и другие ОС на macOS и iOS. Это эмулятор для запуска полноценных виртуальных машин без необходимости джейлбрейка.
MonitorControl превращает любой сторонний монитор в нативный Apple Display. Управляй яркостью и звуком через клавиатуру Mac или шорткаты.
Данные обновлены: 3 июня 2026 г.