Il pannello Problemi analizza il progetto alla ricerca di problemi facili da trascurare mentre si scrive — soprattutto collegamenti e immagini che puntano a qualcosa che non esiste più. È un pannello ancorato nella parte inferiore della finestra, che condivide quell’area con il Terminale e il pannello Trova.
Aprire il pannello Problemi
Fai clic sull’icona Problemi nella barra delle attività all’estrema sinistra per mostrare o nascondere il pannello. Alla prima apertura viene mostrata una scheda Controlla riferimenti per avviare una scansione.
Controlla riferimenti
Controlla riferimenti analizza ogni file Markdown del progetto e segnala i riferimenti che non è possibile risolvere. Rileva:
- File non trovato — un collegamento o un’immagine punta a un file che non esiste (ad esempio, un file rinominato o eliminato)
- Intestazione non trovata — un collegamento
#ancorapunta a un’intestazione non presente nel documento di destinazione - URL esterno irraggiungibile — facoltativamente, un collegamento esterno che restituisce un errore, mostrato con il relativo stato HTTP
Avvia una scansione dalla scheda Controlla riferimenti oppure da Strumenti > Controlla riferimenti nel menu. Durante la scansione il pannello mostra l’avanzamento; al termine i risultati compaiono raggruppati per file.
Leggere i risultati
Ogni file che contiene un problema diventa un gruppo nell’albero e, espandendolo, vengono elencati tutti i riferimenti interrotti presenti in quel file. Ogni voce mostra:
- Il numero di riga in cui compare il riferimento
- Il testo del riferimento così come è scritto nel documento
- Un breve motivo — “file non trovato”, “intestazione … non trovata” oppure lo stato HTTP per un URL irraggiungibile
Fai clic su una voce per aprire il file e passare direttamente alla riga, così da poterla correggere. Dopo aver apportato le modifiche, usa Riesegui scansione per ripetere il controllo e confermare che il problema è risolto.
Correggere un file mancante con Ricollega
Quando un risultato è un collegamento o un’immagine che punta a un file non più presente in quella posizione — ad esempio un’immagine spostata al di fuori di MarkNode — la voce offre un pulsante Ricollega, così non devi modificare il Markdown a mano.
Fai clic su Ricollega e MarkNode cerca nel progetto i file con lo stesso nome:
- Se trova esattamente una corrispondenza, propone quel file — conferma per ricollegarlo.
- Se ne trova più di una, elenca tutte le corrispondenze così puoi scegliere quella giusta.
- Se non ne trova nessuna, ti permette di cercare tu stesso il file, in qualsiasi punto all’interno del progetto.
Nulla cambia finché non confermi un file. Una volta fatto, il riferimento viene aggiornato sul posto e la voce scompare dai risultati.
Quando usarlo
Eseguire Controlla riferimenti è particolarmente utile prima di pubblicare o condividere un documento, dopo una serie di rinomine o riorganizzazioni di file, oppure quando hai spostato contenuti tra documenti. Integra la notifica di collegamento interrotto che compare quando fai clic su un collegamento che non si risolve: il pannello Problemi individua tutti i problemi di questo tipo nell’intero progetto in un’unica passata, anziché uno alla volta.