Blog Metlivi

Zachowaj działanie obrazów w dzienniku Markdown po przeniesieniu folderu

Aby lokalne zdjęcia w dzienniku Markdown nie przestały działać po jego przeniesieniu, przechowuj obrazy w folderze dziennika i odnoś się do każdego z nich za pomocą ścieżki względnej względem notatki, w której go używasz. Następnie przenieś lub skopiuj cały folder, zachowując jego wewnętrzną strukturę, otwórz przeniesioną notatkę w używanej zwykle przeglądarce Markdown i sprawdź, czy przykładowe obrazy się wyświetlają. To, że ścieżka działa w jednym edytorze, nie dowodzi, że każda przeglądarka rozpozna ją tak samo.

30 września 20265 min czytaniaAutor: Metlivi Editorial Team
Sekcja 1

Co oznacza względna ścieżka do obrazu

Składnia obrazów w Markdown używa wykrzyknika, tekstu alternatywnego w nawiasach kwadratowych i lokalizacji obrazu w nawiasach okrągłych. Na przykład Niebieski kubek na biurku wskazuje obraz, opisując jego położenie względem pliku Markdown. Specyfikacja CommonMark pokazuje lokalizacje obrazów, takie jak train.jpg, a Markdown Guide opisuje tę samą podstawową składnię. CommonMark: Obrazy Markdown Guide: Podstawowa składnia

Ścieżka względna przydaje się przy przenoszeniu dziennika, ponieważ opisuje relację między plikami, zamiast wskazywać konkretne miejsce na jednym komputerze. Jeśli notatka i obraz zostaną przeniesione razem, a ich wzajemne położenie się nie zmieni, ścieżka nadal będzie wskazywać ten sam obraz. Ścieżka bezwzględna, taka jak /Users/sam/Pictures/blue-mug.jpg lub C:\Users\Sam\Pictures\blue-mug.jpg, wskazuje konkretne miejsce na komputerze; skopiowanie dziennika na inny dysk lub komputer może sprawić, że przestanie działać.

Sekcja 2

Wybierz strukturę folderów, którą można przenosić w całości

W dzienniku z notatkami uporządkowanymi według lat praktycznym rozwiązaniem jest umieszczenie wspólnego folderu z obrazami obok folderów z latami:

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

Ze ścieżki Diary/2026/2026-09-30.md do pliku blue-mug.jpg prowadzi ścieżka ../images/blue-mug.jpg: przejdź o jeden poziom wyżej z folderu 2026, a następnie otwórz folder images. Linia Markdown może wyglądać tak:

md Niebieski kubek obok otwartego dziennika

Jeśli obrazy z każdego roku dotyczą tylko tego roku, łatwy do zrozumienia jest również sąsiedni podfolder:

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

Wtedy notatka może używać ścieżki Grządka po posadzeniu roślin. Te przykłady zależą od położenia wyświetlanej notatki. Policz katalogi między notatką a obrazem; nie zgaduj liczby segmentów ../.

Sekcja 3

Zapisuj ścieżkę z perspektywy notatki

Zacznij od folderu pliku Markdown, a potem przejdź przez strukturę katalogów do obrazu. Sama nazwa pliku, na przykład photo.jpg, oznacza, że obraz znajduje się obok notatki. Ścieżka images/photo.jpg oznacza, że obraz znajduje się w podfolderze images obok notatki. Ścieżka ../images/photo.jpg oznacza, że najpierw trzeba przejść o jeden poziom wyżej. Ta zasada pozwala obliczyć ścieżkę przed sprawdzeniem jej w przeglądarce.

W miarę możliwości używaj prostych nazw, na przykład 2026-09-30-garden.jpg. W wielu systemach plików liczy się dokładna pisownia i wielkość liter, a literówka lub różnica w wielkości liter może wystarczyć, by obraz stał się niedostępny. Aplikacje Markdown mogą też różnie obsługiwać spacje i znaki interpunkcyjne. Markdown Guide zwraca uwagę, że aplikacje nie są zgodne co do spacji w adresach URL i zaleca używanie %20 dla lepszej zgodności. Jeśli nazwa obrazu zawiera spacje, prosta nazwa pliku pozwala uniknąć tej niepewności; w przeciwnym razie użyj kodowania lub sposobu cytowania obsługiwanego przez przeglądarkę i sprawdź rezultat właśnie w niej. Markdown Guide: Najlepsze praktyki dotyczące linków

Sekcja 4

Przenoś dziennik bez zmieniania jego wewnętrznej mapy

Traktuj folder dziennika jako całość. Skopiuj lub przenieś nadrzędny folder Diary/ wraz z notatkami .md i obrazami, zamiast przenosić same notatki albo zostawiać obrazy w dotychczasowym miejscu. Ścieżki względne przetrwają zmianę zewnętrznego położenia folderu, ponieważ ich wewnętrzny punkt początkowy i cel pozostają w tej samej relacji.

Przy reorganizacji folderów w dzienniku przelicz ścieżki w dotyczących ich notatkach. Na przykład przeniesienie notatki z Diary/2026/ do Diary/2026/trips/ zmienia ścieżkę potrzebną do dotarcia do Diary/images/: teraz trzeba użyć ../../images/blue-mug.jpg. Ścieżka względna obsługuje przeniesienie całego drzewa, ale nie skompensuje automatycznie przestawienia tylko jego części.

Sekcja 5

Przetestuj rzeczywiste przeniesienie w używanej przeglądarce

Zanim zaczniesz polegać na nowym układzie folderów, wykonaj prosty i odwracalny test:

Wybierz notatkę z co najmniej jednym lokalnym obrazem i sprawdź, czy obraz wyświetla się w używanej zwykle przeglądarce Markdown.

Skopiuj cały folder dziennika w inne miejsce, na przykład do innego zwykłego folderu lub na dysk wymienny. Zachowaj wszystkie podfoldery i nazwy plików.

Otwórz skopiowaną notatkę z nowego miejsca w tej samej przeglądarce. Sprawdź, czy obraz się wyświetla, a nie tylko czy w kodzie źródłowym Markdown znajduje się oczekiwany tekst.

Otwórz jeden lub dwa obrazy w notatkach na różnych poziomach folderów, zwłaszcza w notatkach używających ../. Dzięki temu sprawdzisz więcej niż jeden przykład z plikami w tym samym folderze.

Jeśli brakuje obrazu, porównaj ścieżkę z rzeczywistą strukturą folderów: sprawdź folder notatki, każde ../, nazwę każdego podfolderu, pisownię nazwy pliku, rozszerzenie i wielkość liter. Popraw ścieżkę, a następnie ponownie sprawdź przeniesioną kopię.

To praktyczny test, a nie uniwersalna gwarancja dla wszystkich aplikacji. Standard Markdown opisuje składnię obrazów, ale przeglądarki mogą dodawać własne konwencje. Na przykład Obsidian dokumentuje zarówno składnię obrazów Markdown, jak i własną składnię osadzania (![[image.jpg]]), a jego ustawienia osobno opisują formaty linków względnych, względem głównego folderu skarbca i najkrótszych ścieżek. Jeśli otwierasz dziennik w aplikacji opartej na skarbcu, sprawdź, czy używasz standardowych lokalizacji Markdown, czy osadzeń i ustawień linków specyficznych dla aplikacji. Pomoc Obsidian: Osadzanie plików Pomoc Obsidian: Ustawienia

Sekcja 6

Zdiagnozuj niedziałający obraz po przeniesieniu

Jeśli obraz znika, najpierw ustal, którą kopię notatki otworzyła przeglądarka. Łatwo sprawdzić oryginalną notatkę i założyć, że wyświetlana jest przeniesiona kopia. Następnie ręcznie przejdź ścieżkę względną od folderu tej notatki i sprawdź, czy wskazany obraz istnieje w miejscu docelowym.

Aby szybko zawęzić przyczynę, tymczasowo porównaj ścieżkę ze strukturą folderów: jeśli 2026-09-30.md znajduje się w Diary/2026/, ścieżka ../images/blue-mug.jpg powinna prowadzić do Diary/images/blue-mug.jpg. Jeśli ścieżka prowadzi do właściwego folderu, ale plik nazywa się Blue-Mug.JPG, zmień odwołanie do nazwy pliku albo jego nazwę tak, by były identyczne. Jeśli obraz otwiera się w menedżerze plików, ale nie wyświetla w notatce, problem może wynikać ze sposobu, w jaki przeglądarka obsługuje lokalne ścieżki Markdown; sprawdź jej dokumentację lub przetestuj zwykłą lokalizację obrazu Markdown.

Sekcja 7

Prosta zasada przenośności

Przechowuj lokalne obrazy dziennika w jego głównym folderze, zapisuj ścieżkę do każdego obrazu względem notatki, w której jest wyświetlany, i zachowuj strukturę folderów podczas przenoszenia dziennika. Na koniec otwórz przeniesioną kopię w używanej przeglądarce i sprawdź, czy przykładowe obrazy się wyświetlają. Ta procedura pozwala jednocześnie sprawdzić relacje między plikami i działanie aplikacji, dzięki czemu przenośna konfiguracja jest niezawodna w codziennym użyciu.

Warto przeczytać

Eksploruj dalej ten temat