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