トラブルシューティング
画像にアクセスできない
マークダウンファイルの画像に「この画像を表示するにはフォルダーへのアクセスを許可」または「画像が見つかりません」というプレースホルダーが表示される場合、Peekdownにはそれらの画像が含まれるフォルダへのアクセス許可が必要です。
PeekdownはmacOSの安全なサンドボックス内で実行されるため、明示的にアクセス許可を付与したファイルやフォルダにのみアクセスできます。
修正するには：
- 設定 > フォルダを開く
- 共通フォルダ（デスクトップ、書類、ダウンロード）へのアクセスをオンにするか、
- **フォルダを追加…**をクリックして特定の場所へのアクセスを許可
アクセスが許可されると、プレビューは自動的に再読み込みされます。
クイックルックで画像が表示されない
クイックルック（Finderでスペースキーを押す）でマークダウンファイルをプレビューした際に画像が壊れているか表示されない場合、これはmacOSの制限であり、Peekdownの不具合ではありません。
クイックルック拡張機能はプレビュー対象のファイルにのみアクセスできる制限付きサンドボックス内で実行されます。拡張機能はディスク上の他のファイルを読み取れないため、相対パスで参照されたローカル画像（など）は読み込めません。
この制限はmacOSによって強制されており、すべてのクイックルック拡張機能に適用されます。Peekdownでは回避できません。画像を正しく表示するには、Peekdownでファイルを開いてください。
読み込んだ注釈が表示されない
注釈ファイルを読み込んだにもかかわらず注釈が表示されない場合は、ドキュメントを閉じて再度開いてみてください。読み込まれた注釈はPeekdownの内部ストレージに保存され、ファイルを再度開くと自動的に復元されます。
以前のバージョンのPeekdownから書き出された注釈（.peekdownファイル）を読み込もうとしている場合は、まずファイルの拡張子を.jsonに変更してください。フォーマットは同じで、ファイル拡張子のみが変更されています。
「ほかのAppのデータへのアクセス」
注釈のあるファイルを閉じると、macOSが**「Peekdown.appがほかのAppのデータへのアクセスを求めています」**というアラートを表示することがあります。これはmacOSの標準的なプライバシー確認であり、エラーではありません。
表示される理由： PeekdownはFinderでファイルをプレビューする際にクイックルック拡張機能が注釈を表示できるよう、共有コンテナに注釈を保存します。macOS Sequoia（15.0以降）はこの共有コンテナへのアクセスをApp間データ共有として扱い、1回限りのアクセス許可を求めます。
許可（推奨）： クイックルックプレビューに注釈が表示されます。この確認は1回のみ表示されます。
許可しない： メインアプリは通常どおり動作します。唯一の影響は、クイックルックプレビューで注釈が表示されないことです。
後から変更するには： システム設定 > プライバシーとセキュリティ > Appデータを開き、Peekdownのアクセスを切り替えてください。
変更が保存されない
変更が保存されない場合、ファイルが読み取り専用または保護されたディレクトリにある可能性があります：
- Finderでファイルの権限を確認：ファイルを右クリックし、情報を見るを選択して共有とアクセス権を確認
- ファイルへの書き込み権限があることを確認
- ファイル > 別名で保存で別の場所への保存を試す
プレビューがGitHubと一致しない
PeekdownはGitHub Flavored Markdown（GFM）の標準仕様をレンダリングしますが、GitHubは@メンション、Issueリンク、リポジトリ固有の機能などの追加処理を行います。純粋なマークダウンコンテンツでは、レンダリングは同一になります。
Mermaid図と数式（LaTeX）には対応しており、デフォルトでオンになっています。設定 > 動作でオン・オフを切り替えられます。
文字サイズ
テキストが小さすぎるまたは大きすぎる場合：
- ⌘+ で拡大
- ⌘− で縮小
- ⌘⇧0 でデフォルトサイズにリセット
ズームレベルはウインドウごとに記憶されます。
プライバシー
Peekdownは完全にオフラインで動作します。インターネットに接続することは一切ありません。すべてのマークダウンレンダリングはMac上でローカルに処理されます。
- ファイルはディスク上で直接読み書きされます
- 設定はmacOSのデフォルトを使用してローカルに保存されます
- クラウド同期、アカウント、テレメトリはありません
- データの収集や送信は一切行われません