「問題」面板會掃描你的專案,找出撰寫時容易忽略的問題——最重要的是指向已不存在目標的連結與圖片。它是停靠在視窗底部的面板,與「終端機」和「尋找」面板共用該區域。
開啟問題面板
點按最左側活動列中的問題圖示即可顯示或隱藏面板。首次開啟時,面板會顯示一張檢查參照卡片,供你開始掃描。
檢查參照
檢查參照會掃描專案中的每個 Markdown 檔案,並回報無法解析的參照。它可以找出:
- 找不到檔案 — 連結或圖片指向不存在的檔案(例如已重新命名或刪除的檔案)
- 找不到標題 —
#anchor連結指向目標文件中不存在的標題 - 無法連線的外部網址 — 選擇性檢查傳回錯誤的外部連結,並顯示其 HTTP 狀態
你可以從檢查參照卡片開始掃描,或從選單中的工具 > 檢查參照啟動。掃描進行時,面板會顯示進度;完成後,結果會依檔案分組顯示。
檢視結果
每個含有問題的檔案會在樹狀結構中成為一個群組,展開後即可列出該檔案中的每一項失效參照。每一筆項目會顯示:
- 參照所在的行號
- 文件中所寫的參照文字
- 簡短的原因 — 「找不到檔案」、「找不到標題 …」,或無法連線網址的 HTTP 狀態
點按項目即可開啟檔案並跳至該行進行修正。修改後,使用重新掃描再次執行檢查,確認問題已解決。
何時使用
在發布或分享文件之前、在一輪重新命名或重新整理檔案之後,或在文件之間搬移內容之後,執行「檢查參照」最為實用。它補足了你點按無法解析的連結時所看到的行內失效連結通知——「問題」面板會一次掃遍整個專案,找出所有這類問題,而不是一次只處理一個。