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