本文へ移動

QLMarkdown

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

Caskシステムツール自動更新 3,782
インストールコマンド
brew install --cask qlmarkdown
過去 30 日間のインストール数
2,827
Appランキング 120 位
過去1年間のインストール数
3.5万
過去365日間の合計
最新バージョン
1.5.7
ダウンロードサイズ
26MB
zip
更新頻度
不定期
過去30日間に0回リリース

紹介

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とトラブルシューティング、公式1.5.7リリース、ライセンス、Homebrew cask。

基本情報

システム要件
macOS 12 以降
チップ
Apple シリコン · Intel
自動更新
はい
リポジトリ
オープンソース · GPL-3.0 · 48 日前に更新★3,782
開発元
sbarex and contributors
Homebrew
インストール可能、アプリ自身が更新
その他の名前
sbarex QLMarkdown, qlmarkdown
ホームページ
github.com/sbarex/QLMarkdown
パッケージ識別子
qlmarkdown

確認日

1.5.7の更新内容

新バージョン · OpenNavo編集部

  • 修正上付き文字拡張機能が有効な場合の脚注を修正します。

Mac に QLMarkdown をインストールする方法

Homebrew はアプリを「アプリケーション」フォルダにインストールします。

Homebrew を使わずにインストール

Homebrew が使うのと同じファイルをダウンロード: インストール詳細

QLMarkdown のアンインストールと任意のデータ削除

アンインストールのコマンド
brew uninstall --cask qlmarkdown

通常のアンインストールではアプリ本体だけを削除し、設定とキャッシュは残ります。

完全な削除(任意)
アンインストールのコマンド
brew uninstall --zap --cask qlmarkdown

--zap は Homebrew の定義に記載された設定やキャッシュなどのファイルも削除します。ほかのアプリと共有しているデータが含まれる場合があり、削除すると元に戻せません。何も残らないことを保証するものでもありません。残しておきたいデータは先にバックアップしてください。設定とキャッシュを残す場合は、--zap を付けないでください。

QLMarkdown についてよくある質問

QLMarkdown は安全ですか?

QLMarkdown は Homebrew の公式カタログに収録されており、無効化されていません。2026 年 9 月から、Homebrew は macOS の Gatekeeper チェックに通らないアプリを無効化しています。インストール時に Homebrew は、github.com からダウンロードしたファイルを SHA-256 チェックサムで照合します。過去 30 日間に Homebrew 経由で 2,827 回インストールされました。

QLMarkdown はオープンソースですか?

QLMarkdown のソースコードは GitHub(sbarex/QLMarkdown)で公開されており、ライセンスは GPL-3.0 です。

Mac から QLMarkdown を完全にアンインストールするには?

brew uninstall --cask qlmarkdown を実行します。これによりアプリの終了が行われます。設定やキャッシュもまとめて削除するには、brew uninstall --zap --cask qlmarkdown を実行します。--zap は Homebrew の定義に記載された設定やキャッシュなどのファイルも削除します。ほかのアプリと共有しているデータが含まれる場合があり、削除すると元に戻せません。何も残らないことを保証するものでもありません。残しておきたいデータは先にバックアップしてください。設定とキャッシュを残す場合は、--zap を付けないでください。これでさらに 14 個のファイルとフォルダが削除されます(~/Library/Application Support/QLMarkdown など)。

QLMarkdown は Apple シリコン(M1 以降)の Mac に対応していますか?

Apple シリコンと Intel のどちらの Mac にも Homebrew でインストールでき、同じファイルを使います。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 には 2026年10月2日 に追加されました。QLMarkdown は自動でアップデートされます。Homebrew でアップデートするときは brew upgrade --cask --greedy qlmarkdown を実行します。

QLMarkdown をインストールすると、ほかに何が入りますか?

コマンドラインツール 1 個(qlmarkdown_cli)も追加されます。

類似アプリ

  • DockDoormacOSのDockを拡張する無料ツール。ウィンドウのライブプレビュー、個別ウィンドウの切り替え、カスタマイズ可能なデスクトップコントロールを備えています。
  • MonitorControl対応ディスプレイの輝度・コントラスト・音量を操作するMac用無料メニューバーツール。DDC/CI、ソフトウェア調光、キーボードショートカットに対応。
  • OpenLogi対応するLogitech製マウス、キーボード、ウェブカメラ、Litraライトをローカルでカスタマイズできるオープンソースソフト。
  • ShottrMac向けのネイティブなスクリーンショット撮影と編集。注釈、スクロールキャプチャ、ローカルOCR、ピクセル測定、オプションの共有に対応。
もっと見る