O painel de Problemas verifica seu projeto em busca de questões fáceis de passar despercebidas durante a escrita — principalmente 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 de Problemas
Clique no ícone Problemas na barra de atividades, na extremidade esquerda, para mostrar ou ocultar o painel. Ao abri-lo pela primeira vez, ele exibe um cartão Verificar Referências para iniciar uma verificação.
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 seu status HTTP
Inicie uma verificação a partir do cartão Verificar Referências ou pelo menu, em Ferramentas > Verificar Referências. Enquanto a verificação é 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 em que 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 direto para a linha, de modo que você possa corrigi-la. Depois de fazer as alterações, use Verificar novamente para executar a checagem outra vez e confirmar que o problema foi resolvido.
Quando usar
Executar Verificar Referências é mais útil antes de publicar ou compartilhar um documento, depois de 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 de Problemas encontra todas essas questões em todo o projeto de uma só vez, em vez de uma por vez.