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