サポート

ご質問、不具合の報告、機能のご要望は、 [email protected]までお気軽にどうぞ。

よくある質問

スペースバーを押してもプレーンテキストのまま表示される

クイックルックの機能拡張は、macOSが使用する前にオンにしておく必要があります。

1. qlmdをアプリケーションフォルダに移動し、一度起動する
2. システム設定 → 一般 → ログイン項目と機能拡張を開く
3. 拡張機能の一覧からクイックルックを見つけ、qlmdがオンになっていることを確認する
4. プレビューを閉じて、もう一度スペースバーを押す

それでもプレーンテキストのままの場合は、ターミナルでqlmanage -rを実行してクイックルックの ジェネレーターを再読み込みするか、一度ログアウトしてログインし直してください。

qlmdがプレビューできるファイルは？

拡張子が.md、.markdown、.mdown、 .mkdのファイルです。

設定を変更したのに、プレビューが変わらない

設定は次回のプレビューから適用されます。クイックルックのウィンドウを閉じて、もう一度 スペースバーを押してください。macOSはファイルごとにプレビューをキャッシュするため、すでに開いたことのある ドキュメントが古いスタイルのままの場合は、ターミナルでqlmanage -r cacheを実行してください。

コードブロックがハイライトされない

qlmdには厳選された言語セット（Swift、JavaScript、TypeScript、Python、Bash、 JSON、YAML、XML/HTML、CSS、Go、Rust、C、Java、Ruby、SQL、diff、Markdown、および 一般的なエイリアス）が同梱されています。このセットに含まれない言語はハイライトされず、プレーンテキストとして 表示されます。必要な言語を教えていただければ、追加を検討します。

Mermaid図がコードのまま表示される

qlmdアプリのExtensionsタブでMermaidがオンになっているか 確認してください。オンになっている場合、図のソースが正しいMermaid記法ではない 可能性があります——同じドキュメントをGitHubで表示しても同じ問題が起こります。

ドキュメント内の画像が表示されない

相対パスで参照された画像は、ドキュメントが置かれているフォルダを基準に解決されます。 ファイルが移動または名前変更されている場合、qlmdは画像の代わりに代替テキストを表示します。 リモート画像（http:// / https://）は読み込まれません。プレビュー は設計上、ネットワーク接続がブロックされています。

PDFやHTMLファイルとして書き出すには？

qlmdアプリでドキュメントを開いてください——クイックルックのプレビュー自体にはメニューバーがありません—— そのうえでFile → Export as PDF…またはExport as HTML…を選びます。 PDFは用紙サイズのページの束ではなく、ドキュメントの高さに合わせた1枚の連続ページになり、 テキストも選択可能なままです。HTMLファイルは自身のスタイルと使用画像を内包しているため、単体でどこでも開けます。

対応しているmacOSのバージョンは？

qlmdにはmacOS 15（Sequoia）以降が必要です。バージョンは Appleメニュー → このMacについてから確認できます。

qlmdはドキュメントをどこかに送信しますか？

いいえ。すべての描画はMac上で行われ、プレビューはネットワーク接続を開けません。詳しくは プライバシーポリシーをご覧ください。

まだ解決しない場合は

お使いのmacOSのバージョン、qlmdのバージョン（アプリのAboutタブで確認できます）、 可能であれば問題が起きているMarkdownファイルを添えて、 [email protected]までメールしてください。