Come non perdere i collegamenti alle immagini del diario in Markdown dopo aver spostato la cartella

Cosa significa percorso relativo di un'immagine

La sintassi delle immagini in Markdown prevede un punto esclamativo, il testo alternativo tra parentesi quadre e la destinazione dell'immagine tra parentesi tonde. Ad esempio,  punta a un'immagine descrivendone la posizione rispetto al file Markdown. Le specifiche CommonMark illustrano destinazioni di immagini come train.jpg, e la Markdown Guide documenta la stessa sintassi di base. CommonMark: Images Markdown Guide: Basic Syntax

Un percorso relativo è utile quando si sposta un diario perché descrive la relazione tra i file, invece di indicare una posizione specifica su un computer. Se la nota e l'immagine vengono spostate insieme senza modificare tale relazione, il percorso continuerà a puntare alla stessa immagine. Una posizione assoluta come /Users/sam/Pictures/blue-mug.jpg o C:\Users\Sam\Pictures\blue-mug.jpg fa riferimento alla posizione su una macchina specifica; copiando il diario su un'altra unità o su un altro computer il percorso potrebbe non essere più valido.

Scegliere una struttura di cartelle che si sposti in blocco

Per un diario con note organizzate per anno, una struttura pratica consiste nel mantenere una cartella di immagini condivisa accanto alle cartelle degli anni:

text Diary/ ├── images/ │ ├── blue-mug.jpg │ └── garden-bed.png ├── 2025/ │ └── 2025-04-12.md └── 2026/ └── 2026-09-30.md

Da Diary/2026/2026-09-30.md, il percorso per blue-mug.jpg è ../images/blue-mug.jpg: si sale di una cartella da 2026, quindi si entra in images. La riga in Markdown sarà:

md 

Se le immagini di ciascun anno appartengono solo a quell'anno, anche una sottocartella adiacente è facile da gestire:

text Diary/ ├── 2026/ │ ├── images/ │ │ └── garden-bed.png │ └── 2026-09-30.md

In questo caso la nota può usare . Questi esempi dipendono dalla posizione della nota indicata. Conta le cartelle che separano la nota dall'immagine; non tirare a indovinare il numero di segmenti ../.

Scrivere il collegamento dal punto di vista della nota

Inizia dalla cartella del file Markdown, poi risali o scendi nell'albero delle directory fino all'immagine. Una destinazione composta solo dal nome del file come photo.jpg indica che l'immagine si trova insieme alla nota. images/photo.jpg indica che si trova in una sottocartella images accanto alla nota. ../images/photo.jpg significa che bisogna prima salire di un livello. Questa regola offre un modo concreto per calcolare il collegamento prima di provarlo nel visualizzatore.

Usa nomi lineari quando possibile: ad esempio, 2026-09-30-garden.jpg. L'ortografia esatta e l'uso di maiuscole e minuscole sono fondamentali in molti file system; un errore di battitura o una discrepanza tra maiuscole e minuscole possono rendere un'immagine non disponibile. Anche gli spazi e i segni di punteggiatura potrebbero essere gestiti in modo diverso dalle varie applicazioni Markdown. La Markdown Guide segnala che non tutte le applicazioni gestiscono allo stesso modo gli spazi negli URL e consiglia %20 per motivi di compatibilità. Se il nome di un'immagine contiene spazi, un nome file semplice evita queste incertezze; altrimenti, usa la codifica o lo stile di virgolette supportato dal tuo visualizzatore e fai una verifica sul posto. Markdown Guide: Link Best Practices

Spostare il diario senza modificare la mappa interna

Tratta la cartella del diario come un'unica entità. Copia o sposta la cartella principale Diary/ comprensiva sia delle note .md sia delle immagini, anziché spostare solo le note o lasciare indietro le immagini. I percorsi relativi resistono al cambio di posizione esterna della cartella perché il punto di partenza e la destinazione interni mantengono la stessa relazione.

Quando riorganizzi le cartelle all'interno del diario, ricalcola i collegamenti per le note interessate. Ad esempio, spostando una nota da Diary/2026/ a Diary/2026/trips/ cambia il percorso necessario per raggiungere Diary/images/: ora servirà ../../images/blue-mug.jpg. Un collegamento relativo gestisce il trasferimento dell'intero albero, ma non può compensare automaticamente la riorganizzazione di una sola delle sue parti.

Testare uno spostamento reale nel visualizzatore in uso

Effettua un piccolo controllo reversibile prima di fare affidamento su una nuova disposizione delle cartelle:

Scegli una nota con almeno un'immagine locale e verifica che l'immagine sia attualmente visualizzata nel tuo normale visualizzatore Markdown.

Copia l'intera cartella del diario in una posizione diversa, come un'altra normale cartella o un'unità rimovibile. Mantieni intatte tutte le sottocartelle e i nomi dei file.

Apri la nota copiata dalla sua nuova posizione nello stesso visualizzatore. Verifica che l'immagine compaia effettivamente e non solo che il sorgente Markdown contenga il testo previsto.

Apri una o due immagini in note a livelli di profondità diversi, soprattutto note che utilizzano ../. Questo permette di verificare scenari più complessi rispetto a un singolo esempio nella stessa cartella.

Se un'immagine non viene trovata, confronta la destinazione con l'effettivo albero delle cartelle: controlla la cartella di partenza della nota, ogni ../, il nome di ciascuna sottocartella, l'ortografia del nome del file, l'estensione e le maiuscole/minuscole. Correggi il percorso, quindi ripeti il controllo sulla copia spostata.

Si tratta di una verifica pratica, non di una garanzia universale valida per tutte le app. Lo standard Markdown definisce la sintassi delle immagini, ma i visualizzatori possono aggiungere le proprie convenzioni. Ad esempio, Obsidian documenta sia la sintassi delle immagini Markdown sia la propria sintassi di incorporamento (![[image.jpg]]), e le sue impostazioni descrivono separatamente i formati di collegamento relativi, alla radice del vault e con percorso più breve. Se il tuo diario viene aperto in un'app basata su vault, controlla se stai usando destinazioni Markdown standard oppure impostazioni di collegamento e incorporamenti specifici dell'app. Obsidian Help: Embed files Obsidian Help: Settings

Individuare la causa di un'immagine non visualizzata dopo lo spostamento

Se l'immagine scompare, accertati innanzitutto di quale copia della nota sia stata aperta dal visualizzatore. È facile controllare la nota originale pensando di guardare quella spostata. Segui quindi manualmente il percorso relativo a partire dalla directory di quella nota e verifica che l'immagine specificata esista nella cartella di destinazione.

Un modo rapido per circoscrivere il problema è confrontare temporaneamente il percorso con l'albero delle cartelle: se 2026-09-30.md si trova in Diary/2026/, ../images/blue-mug.jpg dovrebbe puntare a Diary/images/blue-mug.jpg. Se il percorso porta alla cartella corretta ma il file si chiama Blue-Mug.JPG, aggiorna il riferimento nel testo o il nome del file in modo che coincidano esattamente. Se l'immagine si apre in un gestore file ma non viene mostrata nella nota, il problema potrebbe riguardare il modo in cui quel particolare visualizzatore gestisce i percorsi Markdown locali; verifica la documentazione del programma o prova a inserire una semplice destinazione immagine Markdown standard.

Una semplice regola per la portabilità

Conserva le immagini locali del diario all'interno della cartella principale del diario stesso, scrivi ogni percorso relativo alla nota che lo mostra e mantieni intatta la struttura delle cartelle quando sposti il diario. Infine, apri la copia spostata nel visualizzatore effettivo e verifica che le immagini rappresentative vengano mostrate. Questa procedura controlla sia le relazioni tra i file sia il comportamento dell'applicazione, garantendo una configurazione portatile e affidabile nell'uso quotidiano.

Continua a esplorare il tema