O painel Problemas verifica o seu projeto em busca de questões fáceis de passar despercebidas durante a escrita — sobretudo links e imagens que apontam para algo que não existe mais. É um painel encaixado na parte inferior da janela, compartilhando essa área com o Terminal e o painel Localizar.
Abrindo o painel Problemas
Clique no ícone Problemas na barra de atividades à extrema esquerda para exibir ou ocultar o painel. Ao abri-lo pela primeira vez, ele mostra um cartão Verificar referências para iniciar uma varredura.
Verificar referências
Verificar referências examina todos os arquivos Markdown do projeto e relata as referências que não podem ser resolvidas. Ele detecta:
- Arquivo não encontrado — um link ou imagem aponta para um arquivo que não existe (por exemplo, um arquivo que foi renomeado ou excluído)
- Título não encontrado — um link
#ancoraaponta para um título que não está presente no documento de destino - URL externa inacessível — opcionalmente, um link externo que retorna um erro, exibido com o respectivo status HTTP
Inicie uma varredura pelo cartão Verificar referências ou por Ferramentas > Verificar referências no menu. Enquanto a varredura é executada, o painel mostra o progresso; ao terminar, os resultados aparecem agrupados por arquivo.
Lendo os resultados
Cada arquivo que contém um problema se torna um grupo na árvore e, ao expandi-lo, são listadas todas as referências quebradas daquele arquivo. Cada entrada mostra:
- O número da linha onde a referência aparece
- O texto da referência conforme escrito no documento
- Um breve motivo — “arquivo não encontrado”, “título … não encontrado” ou o status HTTP de uma URL inacessível
Clique em uma entrada para abrir o arquivo e ir até a linha, para que você possa corrigi-la. Depois de fazer alterações, use Verificar novamente para executar a checagem outra vez e confirmar que o problema foi resolvido.
Corrigindo um arquivo ausente com Revincular
Quando um resultado é um link ou imagem apontando para um arquivo que não existe mais naquele local — por exemplo, uma imagem que você moveu fora do MarkNode —, a entrada oferece um botão Revincular para que você não precise editar o Markdown manualmente.
Clique em Revincular e o MarkNode procura no projeto arquivos com o mesmo nome:
- Se encontrar exatamente uma correspondência, sugere esse arquivo — confirme para revincular a ele.
- Se encontrar mais de uma, lista todas as correspondências para você escolher a certa.
- Se não encontrar nenhuma, permite que você mesmo procure o arquivo, em qualquer lugar dentro do projeto.
Nada muda até você confirmar um arquivo. Ao confirmar, a referência é atualizada no local e a entrada desaparece dos resultados.
Quando usar
Executar Verificar referências é mais útil antes de publicar ou compartilhar um documento, após uma rodada de renomeação ou reorganização de arquivos, ou quando você moveu conteúdo entre documentos. Isso complementa a notificação de link quebrado exibida quando você clica em um link que não é resolvido — o painel Problemas encontra todas essas questões em todo o projeto de uma só vez, em vez de uma por vez.