# QLMarkdown

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

> Это Markdown-версия страницы QLMarkdown на OpenNavo с теми же сведениями, что и на веб-странице: <https://opennavo.com/ru/apps/qlmarkdown>

- **Последняя версия**: `1.5.7`
- **Разработчик**: sbarex and contributors
- **Главная**: <https://github.com/sbarex/QLMarkdown>
- **Категории**: [Системные инструменты](https://opennavo.com/ru/categories/utilities)
- **Установка**: `brew install --cask qlmarkdown`
- **Установки за последние 30 дней**: 2 783
- **Homebrew**: Можно установить, приложение обновляется само
- **Ссылка для загрузки**: <https://github.com/sbarex/QLMarkdown/releases/download/1.5.7/QLMarkdown.zip>
- **SHA-256**: `96cc95553ee63557f7ec58f41a568ff1fe5bca95b6bcd3883709fa8337c685d4`
- **Включает команды**: qlmarkdown_cli

SHA-256 лишь проверяет, что файл скачан полностью; это не сертификат безопасности.

## Состав установки и удаления

```json
[
  {
    "declaration": {
      "uninstall": [
        {
          "quit": "org.sbarex.QLMarkdown"
        }
      ]
    },
    "phase": "uninstall",
    "sources": [],
    "type": "uninstall"
  },
  {
    "declaration": {
      "app": [
        "QLMarkdown.app"
      ],
      "target": "/Applications/QLMarkdown.app"
    },
    "phase": "install",
    "sources": [
      "QLMarkdown.app"
    ],
    "target": "/Applications/QLMarkdown.app",
    "type": "app"
  },
  {
    "declaration": {
      "binary": [
        "$APPDIR/QLMarkdown.app/Contents/Resources/qlmarkdown_cli"
      ],
      "target": "$HOMEBREW_PREFIX/bin/qlmarkdown_cli"
    },
    "phase": "install",
    "sources": [
      "$APPDIR/QLMarkdown.app/Contents/Resources/qlmarkdown_cli"
    ],
    "target": "$HOMEBREW_PREFIX/bin/qlmarkdown_cli",
    "type": "binary"
  },
  {
    "declaration": {
      "zap": [
        {
          "trash": [
            "~/Library/Application Scripts/group.org.sbarex.qlmarkdown",
            "~/Library/Application Scripts/org.sbarex.QLMarkdown",
            "~/Library/Application Scripts/org.sbarex.QLMarkdown.QLExtension",
            "~/Library/Application Scripts/org.sbarex.QLMarkdown.Shortcut-Extension",
            "~/Library/Application Support/QLMarkdown",
            "~/Library/Containers/org.sbarex.QLMarkdown",
            "~/Library/Containers/org.sbarex.QLMarkdown.QLExtension",
            "~/Library/Containers/org.sbarex.QLMarkdown.Shortcut-Extension",
            "~/Library/Group Containers/group.org.sbarex.qlmarkdown",
            "~/Library/Group Containers/org.sbarex.QLMarkdown",
            "~/Library/Group Containers/org.sbarex.qlmarkdown",
            "~/Library/Preferences/org.sbarex.QLMarkdown.plist",
            "~/Library/Preferences/org.sbarex.QLMarkdownXPCHelper.plist",
            "~/Library/QuickLook/QLMarkdown.qlgenerator"
          ]
        }
      ]
    },
    "phase": "cleanup",
    "sources": [],
    "type": "zap"
  }
]
```

## Описание

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 с тегом и руководство по устранению неполадок](https://github.com/sbarex/QLMarkdown/blob/1.5.7/README.md), [Официальный релиз 1.5.7](https://github.com/sbarex/QLMarkdown/releases/tag/1.5.7), [Лицензия](https://github.com/sbarex/QLMarkdown/blob/1.5.7/LICENSE.txt), [Homebrew cask](https://github.com/Homebrew/homebrew-cask/blob/main/Casks/q/qlmarkdown.rb).

## Системные требования

- macOS 12 или новее · Версия приложения: 1.5.7 · Intel · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/q/qlmarkdown.rb> · Проверено 2026-11-21
  - <https://github.com/sbarex/QLMarkdown/releases/download/1.5.7/QLMarkdown.zip>
  - SHA-256: `96cc95553ee63557f7ec58f41a568ff1fe5bca95b6bcd3883709fa8337c685d4`
- macOS 12 или новее · Версия приложения: 1.5.7 · Чип Apple · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/q/qlmarkdown.rb> · Проверено 2026-11-21
  - <https://github.com/sbarex/QLMarkdown/releases/download/1.5.7/QLMarkdown.zip>
  - SHA-256: `96cc95553ee63557f7ec58f41a568ff1fe5bca95b6bcd3883709fa8337c685d4`

## Факты о безопасности QLMarkdown

Здесь перечислены только факты, которые можно проверить, с источником и датой; это не сертификат безопасности. Чтобы проверить скачанные файлы, просканируйте их в OpenNavo на своём Mac.

- <https://github.com/sbarex/QLMarkdown> · Открытый исходный код: Да — <https://github.com/sbarex/QLMarkdown> · Проверено 2026-11-13

## Удаление

- `brew uninstall --cask qlmarkdown`

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

### Глубокая очистка (по желанию)

- `brew uninstall --zap --cask qlmarkdown`

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

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

- Файлы и папки: `~/Library/Application Scripts/group.org.sbarex.qlmarkdown` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/q/qlmarkdown.rb> · Эти пункты взяты из определения Homebrew, проверенного 2026-11-21. Они показывают только то, что по определению должно удаляться, и не означают, что всё это есть на вашем Mac.
- Файлы и папки: `~/Library/Application Scripts/org.sbarex.QLMarkdown` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/q/qlmarkdown.rb> · Эти пункты взяты из определения Homebrew, проверенного 2026-11-21. Они показывают только то, что по определению должно удаляться, и не означают, что всё это есть на вашем Mac.
- Файлы и папки: `~/Library/Application Scripts/org.sbarex.QLMarkdown.QLExtension` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/q/qlmarkdown.rb> · Эти пункты взяты из определения Homebrew, проверенного 2026-11-21. Они показывают только то, что по определению должно удаляться, и не означают, что всё это есть на вашем Mac.
- Файлы и папки: `~/Library/Application Scripts/org.sbarex.QLMarkdown.Shortcut-Extension` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/q/qlmarkdown.rb> · Эти пункты взяты из определения Homebrew, проверенного 2026-11-21. Они показывают только то, что по определению должно удаляться, и не означают, что всё это есть на вашем Mac.
- Файлы и папки: `~/Library/Application Support/QLMarkdown` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/q/qlmarkdown.rb> · Эти пункты взяты из определения Homebrew, проверенного 2026-11-21. Они показывают только то, что по определению должно удаляться, и не означают, что всё это есть на вашем Mac.
- Файлы и папки: `~/Library/Containers/org.sbarex.QLMarkdown` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/q/qlmarkdown.rb> · Эти пункты взяты из определения Homebrew, проверенного 2026-11-21. Они показывают только то, что по определению должно удаляться, и не означают, что всё это есть на вашем Mac.
- Файлы и папки: `~/Library/Containers/org.sbarex.QLMarkdown.QLExtension` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/q/qlmarkdown.rb> · Эти пункты взяты из определения Homebrew, проверенного 2026-11-21. Они показывают только то, что по определению должно удаляться, и не означают, что всё это есть на вашем Mac.
- Файлы и папки: `~/Library/Containers/org.sbarex.QLMarkdown.Shortcut-Extension` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/q/qlmarkdown.rb> · Эти пункты взяты из определения Homebrew, проверенного 2026-11-21. Они показывают только то, что по определению должно удаляться, и не означают, что всё это есть на вашем Mac.
- Файлы и папки: `~/Library/Group Containers/group.org.sbarex.qlmarkdown` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/q/qlmarkdown.rb> · Эти пункты взяты из определения Homebrew, проверенного 2026-11-21. Они показывают только то, что по определению должно удаляться, и не означают, что всё это есть на вашем Mac.
- Файлы и папки: `~/Library/Group Containers/org.sbarex.QLMarkdown` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/q/qlmarkdown.rb> · Эти пункты взяты из определения Homebrew, проверенного 2026-11-21. Они показывают только то, что по определению должно удаляться, и не означают, что всё это есть на вашем Mac.
- Файлы и папки: `~/Library/Group Containers/org.sbarex.qlmarkdown` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/q/qlmarkdown.rb> · Эти пункты взяты из определения Homebrew, проверенного 2026-11-21. Они показывают только то, что по определению должно удаляться, и не означают, что всё это есть на вашем Mac.
- Файлы и папки: `~/Library/Preferences/org.sbarex.QLMarkdown.plist` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/q/qlmarkdown.rb> · Эти пункты взяты из определения Homebrew, проверенного 2026-11-21. Они показывают только то, что по определению должно удаляться, и не означают, что всё это есть на вашем Mac.
- Файлы и папки: `~/Library/Preferences/org.sbarex.QLMarkdownXPCHelper.plist` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/q/qlmarkdown.rb> · Эти пункты взяты из определения Homebrew, проверенного 2026-11-21. Они показывают только то, что по определению должно удаляться, и не означают, что всё это есть на вашем Mac.
- Файлы и папки: `~/Library/QuickLook/QLMarkdown.qlgenerator` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/q/qlmarkdown.rb> · Эти пункты взяты из определения Homebrew, проверенного 2026-11-21. Они показывают только то, что по определению должно удаляться, и не означают, что всё это есть на вашем Mac.

## Примечания к последнему выпуску

### 1.5.7 (2026-10-07)

Исправляет обработку верхних индексов в сносках и встроенное форматирование внутри ячеек таблицы.

**Исправления**

- Исправляет сноски, когда включено расширение верхнего индекса.
- Отображает нижние индексы, верхние индексы, выделения и математические формулы внутри ячеек таблицы.

## Сведения и источники

- <https://opennavo.com/ru/apps/qlmarkdown>
- <https://opennavo.com/ru/apps/qlmarkdown/versions>
- <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/q/qlmarkdown.rb> · Проверено 2026-11-21
- <https://formulae.brew.sh/cask/qlmarkdown>
- <https://github.com/sbarex/QLMarkdown> · Проверено 2026-11-13
