问题

问题面板会扫描你的项目,查找那些在写作过程中容易被忽略的问题——其中最重要的是指向已不存在内容的链接和图片。它是位于窗口底部的停靠面板,与终端和查找面板共用该区域。

打开问题面板

点击最左侧活动栏中的问题图标即可显示或隐藏该面板。首次打开时,面板会显示一张检查引用卡片,用于启动扫描。

检查引用

检查引用会扫描项目中的每个 Markdown 文件,并报告无法解析的引用。它可以捕获:

  • 文件未找到 —— 链接或图片指向了一个不存在的文件(例如,某个已被重命名或删除的文件)
  • 标题未找到 —— #anchor 链接指向了目标文档中不存在的标题
  • 无法访问的外部 URL —— 可选项,返回错误的外部链接,并显示其 HTTP 状态码

你可以从检查引用卡片启动扫描,也可以通过菜单中的工具 > 检查引用启动。扫描运行时,面板会显示进度;扫描完成后,结果会按文件分组显示。

查看结果

每个包含问题的文件都会成为树中的一个分组,展开后会列出该文件中的所有失效引用。每个条目会显示:

  • 引用所在的行号
  • 文档中所写的引用文本
  • 简短的原因 —— “文件未找到”、“标题……未找到”,或无法访问的 URL 的 HTTP 状态码

点击某个条目即可打开对应文件并跳转到该行,以便修复。修改完成后,使用重新扫描再次运行检查,确认问题已解决。

何时使用

在发布或分享文档之前、在批量重命名或重新组织文件之后,或者在文档之间移动内容后,运行检查引用最为有用。它是对内联失效链接提示的补充——当你点击一个无法解析的链接时会看到该提示;而问题面板可以一次性找出整个项目中的所有此类问题,而不是一次只发现一个。