Перейти к содержимому

QLMarkdown

sbarex and contributors · Расширение Quick Look для macOS: просмотр Markdown с форматированием, настройка тем и инструменты преобразования Markdown в HTML.

CaskСистемные инструментыВстроенное обновление 3,8 тыс.
Главная
Команда установки
brew install --cask qlmarkdown
Установки за последние 30 дней
2 783
Приложение: место 123
Установки за последний год
34,9 тыс.
Всего за 365 дней
Последняя версия
1.5.7
Размер загрузки
26МБ
zip
Частота обновлений
Нерегулярно
0 релизов за 30 дней

Описание

QLMarkdown от sbarex — бесплатное приложение с открытым исходным кодом для macOS, устанавливающее расширение Quick Look для предварительного просмотра Markdown с форматированием. Оно подходит разработчикам, техническим авторам и пользователям, которым нужно просматривать документацию в Finder, не открывая полноценный редактор. Этот пакет Homebrew — проект sbarex, не связанный с более ранними проектами с похожими названиями.

Возможности

  • Просмотр Markdown через Quick Look в macOS с рендерингом на основе cmark-gfm.
  • Настройка светлой и тёмной тем, шрифтов, отображения исходного кода и параметров предварительного просмотра.
  • Поддержка таблиц, списков задач, сносок, якорей заголовков и других расширений.
  • Подсветка блоков кода и возможность отображать формулы MathJax или диаграммы Mermaid.
  • Просмотр файлов R Markdown, Quarto, MDX, API Blueprint и textbundle в поддерживаемых форматах.
  • Преобразование Markdown в HTML с помощью встроенного инструмента командной строки или экспериментальных действий Shortcuts.

Установка и включение расширения

Установите приложение с помощью brew install --cask qlmarkdown или распакуйте официальный архив QLMarkdown.zip и переместите QLMarkdown.app в папку Applications. Запустите приложение хотя бы один раз, чтобы macOS обнаружила расширение, а приложение подготовило общие файлы поддержки. В главном приложении нажмите кнопку, открывающую панель настроек Quick Look, и убедитесь, что расширение включено. В актуальных версиях macOS документированный путь таков: «Системные настройки» > «Основные» > «Объекты входа и расширения» > «Quick Look»; в более старых системах настройки расширений организованы иначе.

Выберите поддерживаемый файл Markdown в Finder и нажмите пробел, чтобы просмотреть его. В приложении настройки сохраните параметры сочетанием Command-S или через меню File > Save settings либо включите автосохранение. Встроенный тестовый редактор предназначен для проверки форматирования; разработчик не позиционирует приложение как самостоятельный редактор Markdown или универсальное средство просмотра документов. Предварительный просмотр R Markdown не выполняет код R, а просмотр MDX не отображает JSX.

Если другое приложение также регистрирует поддержку Markdown в Quick Look, его расширение или регистрация типа файла может получить приоритет. В официальном руководстве по устранению неполадок рекомендуется поочерёдно проверять другие расширения Quick Look, чтобы выявить конфликты. В самом cask явно не указаны конфликтующие cask или дополнительные зависимости типа formula. Homebrew также содержит ссылку на инструмент qlmarkdown_cli; он использует собственные настройки и не совместно использует конфигурацию Quick Look приложения.

Требования, разрешения и ограничения платформы

Текущий Homebrew cask требует macOS 12 Monterey или новее и поддерживает процессоры Intel и Apple Silicon. Это приложение Quick Look для macOS; официальная версия для Windows или Linux для этого проекта не подтверждена. Согласно описанию upstream, предварительно собранный релиз подписан и нотариально заверен. Для сборки из исходного кода нужны зависимости для разработки, но они не являются дополнительными требованиями для установки готового приложения.

Расширение Quick Look использует исключение из разрешений только для чтения, чтобы получать локальные изображения для предварительного просмотра; это не означает, что нужно предоставлять общий доступ к универсальному доступу или полному диску. Встраивание локальных изображений и необработанный HTML — отдельные параметры рендеринга. Необработанный HTML может разрешить небезопасное содержимое, тогда как по умолчанию HTML-теги и небезопасные ссылки удаляются; прежде чем включать эту функцию для недоверенных документов, изучите настройки upstream. MathJax и Mermaid могут использовать библиотеки, размещённые в сети, или встраивать код из комплекта, поэтому для режима CDN требуется доступ к интернету. Доступность других удалённых ресурсов также зависит от сети.

Учётные записи, стоимость и лицензия

Приложение — бесплатное ПО с открытым исходным кодом; в комплекте есть файл лицензии GNU GPL версии 3. Для локального предварительного просмотра и преобразования в HTML учётная запись или подписка не нужны; пожертвования необязательны. Размер официального ZIP-архива 1.5.7 составляет 26,322,745 байт — это размер загрузки, а не занимаемое после установки место. Универсальные минимальные требования к объёму ОЗУ или места на диске после установки не установлены.

Снимок экрана — официальный пример из README с тегом, показывающий предварительный просмотр в Mac Quick Look. На нём показан отформатированный Markdown; это не свежий снимок установленной версии 1.5.7.

Источники: Официальный README с тегом и руководство по устранению неполадок, Официальный релиз 1.5.7, Лицензия, Homebrew cask.

Основные сведения

Система
macOS 12 или новее
Процессор
Чип Apple · Intel
Автообновление
Да
Репозиторий
Открытый исходный код · GPL-3.0 · Обновлено 48 дней назад★3,8 тыс.
Разработчик
sbarex and contributors
Homebrew
Можно установить, приложение обновляется само
Другие названия
sbarex QLMarkdown, qlmarkdown
Сайт
github.com/sbarex/QLMarkdown
Идентификатор
qlmarkdown

Проверено

Что нового в 1.5.7

Новая версия · Редакция OpenNavo

  • ИсправленияИсправляет сноски, когда включено расширение верхнего индекса.

Как установить QLMarkdown на Mac

Homebrew устанавливает приложение в папку «Программы».

Установка без Homebrew

Скачайте тот же файл, что использует Homebrew: Сведения об установке

Удаление QLMarkdown и необязательная очистка данных

Команда удаления
brew uninstall --cask qlmarkdown

Обычное удаление стирает приложение, но оставляет настройки и кеш.

Глубокая очистка (по желанию)
Команда удаления
brew uninstall --zap --cask qlmarkdown

--zap также удаляет настройки, кеш и другие файлы, перечисленные в определении Homebrew. Среди них могут быть данные, общие с другими приложениями; после удаления их нельзя восстановить. Полное отсутствие остаточных файлов тоже не гарантируется. Сначала создайте резервную копию данных, которые нужно сохранить. Чтобы сохранить настройки и кеш, не добавляйте --zap.

Частые вопросы о QLMarkdown

Безопасно ли QLMarkdown?

QLMarkdown есть в официальном каталоге Homebrew и не отключено. С сентября 2026 года Homebrew отключает приложения, которые не проходят проверку Gatekeeper в macOS. При установке Homebrew сверяет файл с github.com по контрольной сумме SHA-256. За последние 30 дней его установили через Homebrew 2 783 раза.

Есть ли у QLMarkdown открытый исходный код?

Исходный код QLMarkdown открыт на GitHub (sbarex/QLMarkdown) под лицензией GPL-3.0.

Как полностью удалить QLMarkdown с Mac?

Выполните brew uninstall --cask qlmarkdown. Команда закрывает приложение. Чтобы удалить ещё и настройки с кэшем, выполните brew uninstall --zap --cask qlmarkdown. --zap также удаляет настройки, кеш и другие файлы, перечисленные в определении Homebrew. Среди них могут быть данные, общие с другими приложениями; после удаления их нельзя восстановить. Полное отсутствие остаточных файлов тоже не гарантируется. Сначала создайте резервную копию данных, которые нужно сохранить. Чтобы сохранить настройки и кеш, не добавляйте --zap. Так удалятся ещё 14 файлов и папок, например ~/Library/Application Support/QLMarkdown.

Работает ли QLMarkdown на Mac с чипами Apple (M1 и новее)?

Homebrew устанавливает его и на Mac с чипами Apple, и на Mac с Intel из одного и того же файла. Нужна macOS 12 или новее.

Где QLMarkdown хранит настройки и данные?

Настройки хранятся в ~/Library/Preferences/org.sbarex.QLMarkdown.plist. Данные хранятся в ~/Library/Application Support/QLMarkdown, ~/Library/Containers/org.sbarex.QLMarkdown и ~/Library/Containers/org.sbarex.QLMarkdown.QLExtension. Эти пути взяты из списка очистки Homebrew.

Какая последняя версия QLMarkdown?

Последняя версия — 1.5.7, в Homebrew она появилась 2 окт. 2026 г. QLMarkdown обновляется само; чтобы обновить его через Homebrew, выполните brew upgrade --cask --greedy qlmarkdown.

Что ещё устанавливается вместе с QLMarkdown?

Также добавляется 1 утилита командной строки: qlmarkdown_cli.

Похожие приложения

  • MonitorControlБесплатное управление яркостью, контрастностью и громкостью поддерживаемых дисплеев на Mac: DDC/CI, программное затемнение и сочетания клавиш.
  • DockDoorБесплатное улучшение Dock в macOS с живыми предпросмотрами окон, переключением между отдельными окнами и настраиваемыми элементами управления рабочего стола.
  • ShottrНативное создание и редактирование скриншотов на Mac с аннотациями, захватом с прокруткой, локальным OCR, измерением пикселей и возможностью поделиться.
  • OpenLogiЛокальная настройка поддерживаемых мышей, клавиатур, веб-камер и светильников Litra Logitech в проекте с открытым исходным кодом.
Показать ещё