问题面板会扫描你的项目,查找那些在写作过程中容易被忽略的问题——其中最重要的是指向已不存在内容的链接和图片。它是位于窗口底部的停靠面板,与终端和查找面板共用该区域。
打开问题面板
点击最左侧活动栏中的问题图标即可显示或隐藏该面板。首次打开时,面板会显示一张检查引用卡片,用于启动扫描。
检查引用
检查引用会扫描项目中的每个 Markdown 文件,并报告无法解析的引用。它可以捕获:
- 文件未找到 —— 链接或图片指向了一个不存在的文件(例如,某个已被重命名或删除的文件)
- 标题未找到 ——
#anchor链接指向了目标文档中不存在的标题 - 无法访问的外部 URL —— 可选项,返回错误的外部链接,并显示其 HTTP 状态码
你可以从检查引用卡片启动扫描,也可以通过菜单中的工具 > 检查引用启动。扫描运行时,面板会显示进度;扫描完成后,结果会按文件分组显示。
查看结果
每个包含问题的文件都会成为树中的一个分组,展开后会列出该文件中的所有失效引用。每个条目会显示:
- 引用所在的行号
- 文档中所写的引用文本
- 简短的原因 —— “文件未找到”、“标题……未找到”,或无法访问的 URL 的 HTTP 状态码
点击某个条目即可打开对应文件并跳转到该行,以便修复。修改完成后,使用重新扫描再次运行检查,确认问题已解决。
何时使用
在发布或分享文档之前、在批量重命名或重新组织文件之后,或者在文档之间移动内容后,运行检查引用最为有用。它是对内联失效链接提示的补充——当你点击一个无法解析的链接时会看到该提示;而问题面板可以一次性找出整个项目中的所有此类问题,而不是一次只发现一个。