Панель «Проблемы» проверяет проект на наличие ошибок, которые легко упустить при написании текста, — прежде всего это ссылки и изображения, указывающие на то, чего больше не существует. Это закреплённая панель в нижней части окна, которая делит эту область с Терминалом и панелью поиска.
Открытие панели «Проблемы»
Нажмите значок Проблемы на панели активности слева, чтобы показать или скрыть панель. При первом открытии в ней отображается карточка Проверить ссылки для запуска проверки.
Проверить ссылки
Проверить ссылки сканирует каждый файл Markdown в проекте и сообщает о ссылках, которые не удаётся разрешить. Функция обнаруживает:
- Файл не найден — ссылка или изображение указывает на несуществующий файл (например, файл был переименован или удалён)
- Заголовок не найден — ссылка вида
#anchorуказывает на заголовок, отсутствующий в целевом документе - Недоступный внешний URL — при желании проверяются внешние ссылки, возвращающие ошибку; они отображаются вместе с HTTP-статусом
Запустите проверку с карточки Проверить ссылки или через меню Инструменты > Проверить ссылки. Во время проверки панель показывает ход выполнения; по завершении результаты отображаются сгруппированными по файлам.
Чтение результатов
Каждый файл, содержащий проблему, становится группой в дереве, а при её раскрытии отображаются все нерабочие ссылки в этом файле. Каждая запись содержит:
- Номер строки, где находится ссылка
- Текст ссылки в том виде, в каком он записан в документе
- Краткую причину — «файл не найден», «заголовок … не найден» или HTTP-статус для недоступного URL
Нажмите на запись, чтобы открыть файл и перейти к нужной строке для исправления. После внесения изменений используйте Повторить проверку, чтобы запустить её снова и убедиться, что проблема устранена.
Когда это использовать
Проверку ссылок особенно полезно запускать перед публикацией или отправкой документа, после серии переименований или реорганизации файлов, а также когда вы перемещали содержимое между документами. Она дополняет встроенное уведомление о нерабочей ссылке, которое появляется при нажатии на неразрешимую ссылку: панель «Проблемы» находит все такие ошибки во всём проекте за один проход, а не по одной.