Markdown Buddy › MacのクイックルックでMarkdownを表示する
MacのクイックルックでMarkdownを表示する
macOSは .md ファイルをクイックルックで素のテキストとして表示します。井桁、アスタリスク、縦棒で組まれた表がそのまま並びます。Markdown Buddyはクイックルック機能拡張を追加し、代わりに整形済みの文書を表示します。スペースキーを一度押すだけで、見出しもコードブロックも含めた完成形のページが出ます。
プレビューを有効にする
- Mac App StoreからMarkdown Buddyをインストールし、一度起動します。macOSは機能拡張を含むアプリが一度動くまで、その機能拡張を登録しません。
- システム設定を開き、一般、続いてログイン項目と機能拡張へ進み、クイックルックの下でMarkdown Buddyが有効になっているか確認します。
- Finderで .md ファイルを選び、スペースキーを押します。素のテキストの代わりに整形済みの文書が表示されます。
プレビューで表示されるもの
クイックルックのパネルはアプリと同じ描画エンジンを使うので、簡略化されるものはありません。
- 見出し、太字、斜体、リンク、画像、引用
- 構文ハイライト付きのコードブロック
- 表、タスクリスト、取り消し線
- Mermaid図とKaTeX数式
- YAMLフロントマター。余計な文字列ではなくパネルとして表示
Finderのサムネイル
同じパッケージがサムネイル機能拡張も追加します。.md ファイルが白紙のように見えることはなくなり、アイコン表示、カラム表示、ギャラリー表示で整形済み文書の冒頭が見えます。ノートを集めたフォルダが一目で読み取れるようになります。
プレビューが真っ白なとき
- Markdown Buddyを一度起動してから閉じてください。一度も動いていない機能拡張はmacOSに登録されません。
- システム設定の一般、ログイン項目と機能拡張、クイックルックの欄でチェックが入っているか確認してください。
- ターミナルで qlmanage -r を実行してクイックルックのキャッシュを作り直し、ログアウトして入り直してください。macOSはこの登録情報を強くキャッシュします。
- ファイルの拡張子が本当に .md か確認してください。プレーンテキストとして扱われているファイルは、システム側のプレビューが担当します。
よくある質問
Markdown Buddyを開いていなくても動きますか
はい。一度アプリを起動したあとは、クイックルックもサムネイルも単独で働きます。ファイルを読むためにアプリを開き直す必要はありません。
対応するmacOSのバージョンは
macOS 14.0以降。Appleシリコン搭載MacでもIntel Macでも動作します。
プレビューは文書をどこかに送りますか
いいえ。描画はあなたのMacの中、アプリのサンドボックス内で完結します。Markdown Buddyはデータを一切収集せず、ファイル表示のためのネットワーク通信も行いません。
GitリポジトリのREADMEもプレビューできますか
はい、ディスク上のあらゆる .md ファイルに対応します。文書内の相対リンクや画像は、そのファイルが置かれたフォルダを基準に解決されます。