# QLMarkdown

書式付きMarkdownをプレビューするmacOS Quick Look拡張機能。テーマを設定でき、MarkdownからHTMLへの変換ツールも備えています。

> これは OpenNavo の QLMarkdown ページの Markdown 版で、内容はウェブページと同じです： <https://opennavo.com/ja/apps/qlmarkdown>

- **最新バージョン**: `1.5.7`
- **開発元**: sbarex and contributors
- **ホームページ**: <https://github.com/sbarex/QLMarkdown>
- **カテゴリ**: [システムツール](https://opennavo.com/ja/categories/utilities)
- **インストール**: `brew install --cask qlmarkdown`
- **過去 30 日間のインストール数**: 2,783
- **Homebrew**: インストール可能、アプリ自身が更新
- **ダウンロードURL**: <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 by sbarexは、書式付きMarkdownプレビュー用のQuick Look拡張機能をインストールする、無料のオープンソースmacOSアプリケーションです。Finderでドキュメントを確認する際に、フル機能のエディタを開きたくない開発者、テクニカルライター、ユーザーに適しています。このHomebrewパッケージはsbarexプロジェクトのもので、似た名前の旧プロジェクトとは別です。

### 機能
- cmark-gfmベースのレンダリングを使用し、macOS Quick LookでMarkdownをプレビュー。
- ライト／ダークテーマ、フォント、ソースのレンダリング、プレビュー設定を構成。
- 表、タスクリスト、脚注、見出しアンカーなどの拡張機能に対応。
- フェンス付きコードをハイライト表示し、オプションでMathJaxの数式やMermaid図をレンダリング。
- 対応するR Markdown、Quarto、MDX、API Blueprint、textbundleファイルをプレビュー。
- 付属のコマンドラインツールまたは実験的なShortcutsアクションを使ってMarkdownをHTMLに変換。

### インストールと拡張機能の有効化
`brew install --cask qlmarkdown`でインストールするか、公式のQLMarkdown.zipを展開してQLMarkdown.appをApplicationsに配置します。macOSが拡張機能を検出し、アプリが共有サポートファイルを準備できるよう、アプリを少なくとも一度起動してください。メインアプリでQuick Look設定パネルを開くボタンを使い、拡張機能が有効になっていることを確認します。現行のmacOSでは、案内されている場所は「システム設定」>「一般」>「ログイン項目と機能拡張」>「Quick Look」です。旧システムでは拡張機能の設定場所が異なります。

Finderで対応するMarkdownファイルを選択し、Spaceキーを押してプレビューします。設定アプリでは、Command-Sまたは「ファイル」>「設定を保存」で設定を保存するか、自動保存を有効にします。インラインテストエディタは書式の確認用です。開発者は、このアプリを単体の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に対応しています。これはmacOSのQuick Lookアプリケーションです。このプロジェクトの公式Windows版またはLinux版クライアントは確認されていません。上流の説明によると、コンパイル済みリリースは署名および公証済みです。ソースからビルドするには開発用の依存関係が必要ですが、パッケージ版アプリの追加インストール要件ではありません。

Quick Look拡張機能は、ローカルのプレビュー画像を解決するために読み取り専用の権限例外を使用します。これは、アクセシビリティやフルディスクアクセスを一般的に許可する要件ではありません。ローカル画像の埋め込みと生HTMLは別々のレンダリング設定です。生HTMLは危険なコンテンツを許可する可能性があります。デフォルトではHTMLタグと危険なリンクは除去されます。信頼できないドキュメントで有効にする前に、上流の設定を確認してください。MathJaxとMermaidはネットワーク上のライブラリを使うか、バンドルされたコードを埋め込むことができます。そのため、CDNモードにはインターネット接続が必要です。その他のリモートリソースもネットワークの利用可否に左右されます。

### アカウント、料金、ライセンス
このアプリは無料のオープンソースソフトウェアで、GNU GPL version 3のライセンスファイルが付属します。ローカルでのプレビューやHTML変換にアカウントやサブスクリプションは不要です。寄付は任意です。公式の1.5.7 ZIPは26,322,745バイトです。これは転送サイズであり、インストール後の容量ではありません。RAMやインストール容量について、すべての環境に共通する最低要件は確認されていません。

スクリーンショットは、タグ付きの公式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/ja/apps/qlmarkdown>
- <https://opennavo.com/ja/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 に確認
