Markdown-dagboekafbeeldingen werkend houden na het verplaatsen van de map
Om te voorkomen dat lokale foto's in een Markdown-dagboek niet meer werken wanneer je het verplaatst, sla je de afbeeldingen op in de dagboekmap en verwijs je naar elke afbeelding met een relatief pad vanaf de notitie waarin je die gebruikt. Verplaats of kopieer vervolgens de hele map met behoud van de interne structuur, open de verplaatste notitie in je gebruikelijke Markdown-viewer en controleer of de voorbeeldafbeeldingen worden weergegeven. Dat een pad in één editor werkt, bewijst niet dat elke viewer het op dezelfde manier oplost.
Wat een relatief afbeeldingspad betekent
De Markdown-syntaxis voor afbeeldingen gebruikt een uitroepteken, alternatieve tekst tussen vierkante haken en een afbeeldingsbestemming tussen haakjes. Zo verwijst Een blauwe mok op het bureau naar een afbeelding door de locatie ervan ten opzichte van het Markdown-bestand te beschrijven. De CommonMark-specificatie toont afbeeldingsbestemmingen zoals train.jpg, en de Markdown Guide documenteert dezelfde basissyntaxis. CommonMark: Afbeeldingen Markdown Guide: Basissyntaxis
Een relatief pad is handig als je een dagboek verplaatst, omdat het een relatie tussen bestanden beschrijft in plaats van een specifieke locatie op één computer te benoemen. Als de notitie en afbeelding samen worden verplaatst zonder dat die relatie verandert, verwijst het pad nog steeds naar dezelfde afbeelding. Een absolute locatie zoals /Users/sam/Pictures/blue-mug.jpg of C:\Users\Sam\Pictures\blue-mug.jpg benoemt een specifieke locatie op een computer; als je het dagboek naar een andere schijf of computer kopieert, kan het pad ongeldig worden.
Kies een mapstructuur die als geheel kan worden verplaatst
Voor een dagboek met notities die per jaar zijn ingedeeld, is het praktisch om één gedeelde afbeeldingenmap naast de jaartalmappen te bewaren:
text Diary/ ├── images/ │ ├── blue-mug.jpg │ └── garden-bed.png ├── 2025/ │ └── 2025-04-12.md └── 2026/ └── 2026-09-30.md
Vanuit Diary/2026/2026-09-30.md is het pad naar blue-mug.jpg ../images/blue-mug.jpg: ga vanuit 2026 één map omhoog en ga vervolgens naar images. De Markdown-regel kan er zo uitzien:
md Blauwe mok naast het open dagboek
Als de afbeeldingen van elk jaar alleen bij dat jaar horen, is een aangrenzende submap ook gemakkelijk te begrijpen:
text Diary/ ├── 2026/ │ ├── images/ │ │ └── garden-bed.png │ └── 2026-09-30.md
De notitie kan dan Moestuinbed na het planten gebruiken. Deze voorbeelden zijn gebaseerd op de getoonde locatie van de notitie. Tel de mappen tussen de notitie en de afbeelding; gok niet hoeveel ../-segmenten je nodig hebt.
Schrijf de link vanuit het perspectief van de notitie
Begin in de map van het Markdown-bestand en volg dan de mappenstructuur naar de afbeelding. Een bestemming die alleen uit een bestandsnaam bestaat, zoals photo.jpg, betekent dat de afbeelding naast de notitie staat. images/photo.jpg betekent dat de afbeelding in een submap images naast de notitie staat. ../images/photo.jpg betekent dat je eerst één niveau omhoog gaat. Zo kun je de link concreet berekenen voordat je hem in de viewer uitprobeert.
Houd namen waar dat praktisch is eenvoudig: bijvoorbeeld 2026-09-30-garden.jpg. De exacte spelling en hoofdletters zijn op veel bestandssystemen van belang; een typefout of verschil in hoofdletters kan al genoeg zijn om een afbeelding onbeschikbaar te maken. Markdown-apps kunnen ook verschillend omgaan met spaties en leestekens. De Markdown Guide vermeldt dat apps het niet allemaal eens zijn over spaties in URL's en beveelt voor compatibiliteit %20 aan. Als een afbeeldingsnaam spaties bevat, voorkomt een eenvoudige bestandsnaam die onzekerheid; gebruik anders de coderings- of aanhalingstekensyntaxis die je viewer ondersteunt en controleer het resultaat daarin. Markdown Guide: Aanbevolen werkwijzen voor links
Verplaats het dagboek zonder de interne structuur te veranderen
Behandel de dagboekmap als één geheel. Kopieer of verplaats de bovenliggende map Diary/ met zowel de .md-notities als de afbeeldingen, in plaats van alleen de notities te verplaatsen of de afbeeldingen achter te laten. Relatieve paden blijven werken wanneer de map als geheel naar een andere locatie wordt verplaatst, omdat hun interne beginpunt en bestemming dezelfde relatie behouden.
Bereken links voor de betrokken notities opnieuw wanneer je mappen binnen het dagboek herstructureert. Als je bijvoorbeeld een notitie verplaatst van Diary/2026/ naar Diary/2026/trips/, verandert het pad dat nodig is om Diary/images/ te bereiken: nu is ../../images/blue-mug.jpg nodig. Een relatief pad werkt bij het verplaatsen van de hele mappenstructuur, maar kan niet automatisch een herschikking van slechts een deel ervan opvangen.
Test een echte verplaatsing in de viewer die je gebruikt
Voer een kleine, omkeerbare controle uit voordat je op een nieuwe mapindeling vertrouwt:
Kies een notitie met minstens één lokale afbeelding en controleer of de afbeelding momenteel wordt weergegeven in je gebruikelijke Markdown-viewer.
Kopieer de volledige dagboekmap naar een andere locatie, zoals een andere gewone map of een verwisselbare schijf. Behoud alle submappen en bestandsnamen.
Open de gekopieerde notitie vanaf de nieuwe locatie in dezelfde viewer. Controleer of de afbeelding wordt weergegeven; kijk niet alleen of de Markdown-bron de verwachte tekst bevat.
Open een of twee afbeeldingen in notities op verschillende niveaus, vooral notities die ../ gebruiken. Zo controleer je meer dan één voorbeeld waarbij alles in dezelfde map staat.
Als een afbeelding ontbreekt, vergelijk je de bestemming met de daadwerkelijke mappenstructuur: controleer de beginmap van de notitie, elke ../, alle submapnamen, de spelling van de bestandsnaam, de extensie en de hoofdletters. Corrigeer het pad en herhaal de controle op de verplaatste kopie.
Dit is een praktische test, geen universele garantie voor alle apps. Standaard Markdown beschrijft de afbeeldingssyntaxis, maar viewers kunnen hun eigen conventies toevoegen. Obsidian documenteert bijvoorbeeld zowel de Markdown-syntaxis voor afbeeldingen als de eigen insluitsyntaxis (![[image.jpg]]), en beschrijft in afzonderlijke instellingen relatieve, kluisbasis- en kortste-padformaten voor links. Als je het dagboek in een app met kluisstructuur opent, controleer dan of je standaard Markdown-bestemmingen of app-specifieke insluitingen en linkinstellingen gebruikt. Obsidian Help: Bestanden insluiten Obsidian Help: Instellingen
Een kapotte afbeelding na het verplaatsen opsporen
Als de afbeelding verdwijnt, controleer dan eerst welke kopie van de notitie de viewer heeft geopend. Het is gemakkelijk om de oorspronkelijke notitie te bekijken en aan te nemen dat de verplaatste versie wordt weergegeven. Volg vervolgens het relatieve pad handmatig vanaf de map van die notitie en controleer of de genoemde afbeelding op de bestemming staat.
Je kunt de oorzaak snel afbakenen door het pad tijdelijk met de mappenstructuur te vergelijken: als 2026-09-30.md in Diary/2026/ staat, hoort ../images/blue-mug.jpg te verwijzen naar Diary/images/blue-mug.jpg. Als het pad de bedoelde map bereikt, maar het bestand Blue-Mug.JPG heet, pas dan de bestandsverwijzing of de bestandsnaam aan zodat ze exact overeenkomen. Als de afbeelding in een bestandsbrowser opent maar niet in de notitie wordt weergegeven, kan het resterende probleem liggen in de manier waarop die viewer lokale Markdown-paden verwerkt; raadpleeg de documentatie of test een gewone Markdown-bestemming voor een afbeelding.
Een eenvoudige regel voor draagbaarheid
Bewaar lokale dagboekafbeeldingen onder de hoofdmap van het dagboek, schrijf elk afbeeldingspad relatief ten opzichte van de notitie waarin de afbeelding wordt weergegeven en behoud de mappenstructuur wanneer je het dagboek verplaatst. Open ten slotte de verplaatste kopie in de daadwerkelijke viewer en controleer of representatieve afbeeldingen worden weergegeven. Zo controleer je tegelijk de relatie tussen de bestanden en het gedrag van de app; daardoor is een draagbare opstelling betrouwbaar in dagelijks gebruik.