Blog Metlivi

Menjaga Gambar Catatan Harian Markdown Tetap Berfungsi Setelah Memindahkan Folder

Agar foto lokal di catatan harian Markdown tidak rusak saat dipindahkan, simpan gambar di dalam folder catatan harian dan tautkan masing-masing gambar dengan jalur relatif dari catatan yang menggunakannya. Kemudian pindahkan atau salin seluruh folder sambil mempertahankan tata letak internalnya, buka catatan yang telah dipindahkan di penampil Markdown yang biasa Anda gunakan, dan periksa apakah contoh gambar ditampilkan dengan benar. Jalur yang berfungsi di satu editor bukanlah bukti bahwa setiap penampil akan memprosesnya dengan cara yang sama.

30 September 20265 min readEstetika sehari-hari dan ekspresi diriOleh Metlivi Editorial Team
Bagian 1

Apa arti jalur gambar relatif

Sintaksis gambar Markdown menggunakan tanda seru, teks alternatif dalam tanda kurung siku, dan tujuan gambar dalam tanda kurung. Misalnya, ![A blue mug on the desk](../images/blue-mug.jpg) mengarah ke sebuah gambar dengan mendeskripsikan lokasinya relatif terhadap file Markdown tersebut. Spesifikasi CommonMark mengilustrasikan tujuan gambar seperti train.jpg, dan Markdown Guide mendokumentasikan sintaksis dasar yang sama. CommonMark: Images Markdown Guide: Basic Syntax

Jalur relatif berguna untuk memindahkan catatan harian karena jalur ini mendeskripsikan hubungan antarfile, alih-alih menyebutkan lokasi tertentu pada satu komputer. Jika catatan dan gambar dipindahkan bersama tanpa mengubah hubungan tersebut, jalurnya akan tetap mengarah ke gambar yang sama. Lokasi absolut seperti /Users/sam/Pictures/blue-mug.jpg atau C:\Users\Sam\Pictures\blue-mug.jpg menyebutkan lokasi spesifik di perangkat; menyalin catatan harian ke drive atau komputer lain dapat membuatnya tidak valid.

Bagian 2

Pilih tata letak folder yang berpindah bersama

Untuk catatan harian dengan catatan yang diatur berdasarkan tahun, salah satu tata letak praktis adalah menyimpan folder gambar bersama di samping folder tahun:

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

Dari Diary/2026/2026-09-30.md, jalur ke blue-mug.jpg adalah ../images/blue-mug.jpg: naik satu direktori dari 2026, lalu masuk ke images. Baris Markdown-nya bisa berupa:

md ![Blue mug beside the open diary](../images/blue-mug.jpg)

Jika gambar setiap tahun hanya dimiliki oleh tahun tersebut, subfolder yang berdampingan juga mudah dipahami:

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

Kemudian catatan tersebut dapat menggunakan ![Garden bed after planting](images/garden-bed.png). Contoh-contoh ini bergantung pada lokasi catatan yang ditampilkan. Hitung direktori antara catatan dan gambar; jangan menebak jumlah segmen ../.

Bagian 3

Tulis tautan dari sudut pandang catatan

Mulailah dari folder file Markdown, lalu telusuri pohon direktori menuju gambar. Tujuan yang hanya berupa nama file seperti photo.jpg berarti gambar tersebut berada di samping catatan. images/photo.jpg berarti gambar berada di subfolder images di samping catatan. ../images/photo.jpg berarti naik satu tingkat terlebih dahulu. Aturan ini memberikan cara konkret untuk memperhitungkan tautan sebelum mencobanya di penampil.

Gunakan nama yang sederhana jika memungkinkan: misalnya, 2026-09-30-garden.jpg. Ejaan dan kapitalisasi yang tepat sangat berpengaruh pada banyak sistem file, dan salah ketik atau ketidakcocokan huruf besar/kecil sudah cukup untuk membuat gambar tidak dapat diakses. Spasi dan tanda baca juga dapat ditangani secara berbeda oleh aplikasi Markdown. Markdown Guide mencatat bahwa tidak semua aplikasi menyepakati perlakuan spasi dalam URL dan merekomendasikan %20 untuk kompatibilitas. Jika nama gambar mengandung spasi, nama file yang sederhana akan menghindari ketidakpastian tersebut; jika tidak, gunakan gaya penyandian atau tanda kutip yang didukung oleh penampil Anda dan verifikasi di sana. Markdown Guide: Link Best Practices

Bagian 4

Pindahkan catatan harian tanpa mengubah peta internalnya

Perlakukan folder catatan harian sebagai satu kesatuan. Salin atau pindahkan folder Diary/ induk beserta catatan .md dan gambarnya, alih-alih hanya memindahkan catatan atau meninggalkan gambarnya. Jalur relatif tetap berfungsi meski lokasi luar folder berubah karena titik awal dan tujuan internalnya tetap berada dalam hubungan yang sama.

Saat mengatur ulang folder di dalam catatan harian, hitung ulang tautan untuk catatan yang terpengaruh. Misalnya, memindahkan catatan dari Diary/2026/ ke Diary/2026/trips/ mengubah jalur yang dibutuhkannya untuk mencapai Diary/images/: sekarang diperlukan ../../images/blue-mug.jpg. Tautan relatif dapat menangani relokasi seluruh pohon direktori, tetapi tidak dapat secara otomatis mengimbangi penataan ulang sebagian saja dari pohon tersebut.

Bagian 5

Uji pemindahan sebenarnya di penampil yang Anda gunakan

Lakukan pemeriksaan kecil yang dapat dibatalkan sebelum mengandalkan susunan folder yang baru:

Pilih catatan dengan setidaknya satu gambar lokal dan pastikan gambar tersebut saat ini tampil di penampil Markdown biasa Anda.

Salin folder catatan harian lengkap ke lokasi lain, seperti folder biasa lainnya atau drive portabel. Pertahankan semua subfolder dan nama file.

Buka catatan yang telah disalin dari lokasi barunya di penampil yang sama. Pastikan gambar muncul, bukan hanya teks Markdown yang diharapkan.

Buka satu atau dua gambar dalam catatan di kedalaman folder yang berbeda, terutama catatan yang menggunakan ../. Ini untuk memeriksa lebih dari sekadar contoh dalam folder yang sama.

Jika gambar tidak muncul, bandingkan tujuannya dengan bagan folder sebenarnya: periksa folder catatan awal, setiap ../, nama setiap subfolder, ejaan nama file, ekstensi, dan kapitalisasi. Perbaiki jalurnya, lalu ulangi pemeriksaan pada salinan yang telah dipindahkan.

Ini adalah pengujian praktis, bukan jaminan universal di seluruh aplikasi. Markdown standar mendeskripsikan sintaksis gambar, tetapi penampil dapat menambahkan konvensinya sendiri. Misalnya, Obsidian mendokumentasikan sintaksis gambar Markdown dan sintaksis sematannya sendiri (![[image.jpg]]), serta pengaturannya secara terpisah mendeskripsikan format tautan relatif, vault-root, dan jalur terpendek. Jika catatan harian Anda dibuka di aplikasi berbasis brankas (vault), periksa apakah Anda menggunakan tujuan Markdown standar atau sematan dan pengaturan tautan khusus aplikasi. Obsidian Help: Embed files Obsidian Help: Settings

Bagian 6

Mendiagnosis gambar yang rusak setelah pemindahan

Jika gambar menghilang, pertama-tama pastikan salinan catatan mana yang dibuka oleh penampil. Sangat mudah untuk memeriksa catatan asli dan mengira salinan yang dipindahkan sedang ditampilkan. Kemudian ikuti jalur relatif secara manual dari direktori catatan tersebut dan pastikan gambar yang dimaksud memang ada di tujuan.

Cara cepat untuk mempersempit masalah adalah dengan membandingkan jalur secara langsung dengan pohon folder: jika 2026-09-30.md berada di Diary/2026/, ../images/blue-mug.jpg seharusnya mengarah ke Diary/images/blue-mug.jpg. Jika jalur sudah menuju ke folder yang tepat tetapi file tersebut bernama Blue-Mug.JPG, perbarui referensi nama file atau nama file itu sendiri agar cocok secara tepat. Jika gambar dapat dibuka di pengelola file tetapi tidak ditampilkan di catatan, masalah selebihnya mungkin terletak pada cara penampil tersebut menangani jalur Markdown lokal; verifikasi dengan dokumentasinya atau uji tujuan gambar Markdown biasa.

Bagian 7

Aturan portabilitas sederhana

Simpan gambar catatan harian lokal di bawah folder tingkat atas catatan harian, tulis setiap jalur gambar secara relatif terhadap catatan yang menampilkannya, dan pertahankan struktur folder saat memindahkan catatan harian. Terakhir, buka salinan yang dipindahkan di penampil sebenarnya dan pastikan gambar representatif berhasil ditampilkan. Rutinitas tersebut memeriksa hubungan file sekaligus perilaku aplikasi secara bersamaan, yang membuat pengaturan portabel dapat diandalkan dalam penggunaan sehari-hari.

Bacaan terkait

Lanjutkan topik ini