Blog de Metlivi

Cómo mantener las imágenes de un diario en Markdown funcionando tras mover la carpeta

Para evitar que las fotos locales de un diario en Markdown se rompan al moverlo, guarda las imágenes dentro de la carpeta del diario y vincula cada una con una ruta relativa desde la nota que la utiliza. Luego, mueve o copia la carpeta completa conservando su estructura interna, abre la nota trasladada en tu visor habitual de Markdown y comprueba que las imágenes de muestra se rendericen. Que una ruta funcione en un editor no garantiza que todos los visores la resuelvan de la misma manera.

30 de septiembre de 20265 min readEstética cotidiana y expresión personalPor Metlivi Editorial Team
Sección 1

Qué significa una ruta de imagen relativa

La sintaxis de imágenes en Markdown utiliza un signo de exclamación, texto alternativo entre corchetes y el destino de la imagen entre paréntesis. Por ejemplo, ![A blue mug on the desk](../images/blue-mug.jpg) apunta a una imagen describiendo su ubicación en relación con el archivo Markdown. La especificación CommonMark ilustra destinos de imágenes como train.jpg, y la Markdown Guide documenta la misma sintaxis básica. CommonMark: Images Markdown Guide: Basic Syntax

Una ruta relativa resulta útil para mover un diario porque describe una relación entre archivos, en lugar de indicar una ubicación concreta en un ordenador específico. Si la nota y la imagen se mueven juntas sin alterar esa relación, la ruta seguirá apuntando a la misma imagen. Una ubicación absoluta como /Users/sam/Pictures/blue-mug.jpg o C:\\Users\\Sam\\Pictures\\blue-mug.jpg señala una ubicación específica de la máquina; copiar el diario a otra unidad o a otro ordenador puede hacer que deje de ser válida.

Sección 2

Elige una estructura de carpetas que se mueva en conjunto

Para un diario con notas organizadas por año, una estructura práctica consiste en mantener una carpeta compartida de imágenes junto a las carpetas de los años:

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

Desde Diary/2026/2026-09-30.md, la ruta hacia blue-mug.jpg es ../images/blue-mug.jpg: sube un directorio desde 2026 y luego entra en images. La línea de Markdown podría ser:

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

Si las imágenes de cada año pertenecen únicamente a ese año, una subcarpeta adyacente también es fácil de razonar:

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

En ese caso, la nota puede utilizar ![Garden bed after planting](images/garden-bed.png). Estos ejemplos dependen de la ubicación de la nota visualizada. Cuenta los directorios entre la nota y la imagen; no adivines la cantidad de segmentos ../.

Sección 3

Escribe el enlace desde el punto de vista de la nota

Comienza en la carpeta del archivo Markdown y luego recorre el árbol de directorios hasta llegar a la imagen. Un destino que incluya únicamente el nombre del archivo, como photo.jpg, indica que la imagen se encuentra junto a la nota. images/photo.jpg significa que está en una subcarpeta llamada images junto a la nota. ../images/photo.jpg significa que primero se debe subir un nivel. Esta regla ofrece un método concreto para calcular el enlace antes de probarlo en el visor.

Mantén nombres sencillos siempre que sea práctico: por ejemplo, 2026-09-30-garden.jpg. La ortografía exacta y el uso de mayúsculas y minúsculas son determinantes en muchos sistemas de archivos, y una errata o una discrepancia entre mayúsculas y minúsculas puede ser suficiente para que la imagen no esté disponible. Los espacios y los signos de puntuación también pueden gestionarse de forma distinta según la aplicación de Markdown. La Markdown Guide señala que las aplicaciones no coinciden siempre respecto a los espacios en las URL y recomienda %20 por compatibilidad. Si el nombre de una imagen contiene espacios, usar un nombre de archivo simple evita esa incertidumbre; de lo contrario, utiliza la codificación o el formato de comillas admitido por tu visor y verifícalo allí. Markdown Guide: Link Best Practices

Sección 4

Mueve el diario sin alterar su mapa interno

Trata la carpeta del diario como una unidad. Copia o mueve la carpeta contenedora Diary/ junto con las notas .md y las imágenes, en lugar de mover únicamente las notas o dejar atrás las imágenes. Las rutas relativas se conservan ante un cambio en la ubicación externa de la carpeta porque el punto de partida interno y el destino mantienen la misma relación.

Al reorganizar carpetas dentro del diario, recalcula los enlaces de las notas afectadas. Por ejemplo, mover una nota de Diary/2026/ a Diary/2026/trips/ modifica la ruta necesaria para llegar a Diary/images/: ahora requerirá ../../images/blue-mug.jpg. Un enlace relativo soporta la reubicación de todo el árbol, pero no puede compensar automáticamente la reorganización de solo una parte de él.

Sección 5

Prueba un traslado real en el visor que utilizas

Realiza una comprobación pequeña y reversible antes de confiar en una nueva disposición de carpetas:

Elige una nota con al menos una imagen local y confirma que la imagen se muestre actualmente en tu visor habitual de Markdown.

Copia la carpeta completa del diario a otra ubicación, como otra carpeta ordinaria o una unidad extraíble. Conserva todas las subcarpetas y los nombres de archivo.

Abre la nota copiada desde su nueva ubicación en el mismo visor. Confirma que la imagen se visualice y no solo que la fuente Markdown contenga el texto esperado.

Abre una o dos imágenes en notas ubicadas en distintos niveles de profundidad, especialmente aquellas que utilicen ../. Esto permite verificar más casos que un simple ejemplo dentro de la misma carpeta.

Si falta una imagen, compara el destino con el árbol de carpetas real: revisa la carpeta de la nota de origen, cada ../, el nombre de cada subcarpeta, la ortografía del archivo, su extensión y el uso de mayúsculas y minúsculas. Corrige la ruta y repite la comprobación en la copia trasladada.

Esta es una prueba práctica, no una garantía universal entre aplicaciones. El estándar Markdown describe la sintaxis de imágenes, pero los visores pueden añadir sus propias convenciones. Por ejemplo, Obsidian documenta tanto la sintaxis de imagen de Markdown como su propia sintaxis de incrustación (![[image.jpg]]), y su configuración distingue entre formatos de enlace relativos, desde la raíz del vault o de ruta más corta. Si abres tu diario en una aplicación basada en bóvedas (vaults), comprueba si estás utilizando destinos estándar de Markdown o incrustaciones y ajustes de enlace específicos de la aplicación. Obsidian Help: Embed files Obsidian Help: Settings

Sección 6

Diagnostica una imagen rota tras el traslado

Si la imagen desaparece, primero determina qué copia de la nota abrió el visor. Es fácil inspeccionar la nota original asumiendo que se está visualizando la trasladada. Luego, sigue la ruta relativa manualmente desde el directorio de esa nota y confirma que la imagen indicada exista en el destino.

Una forma rápida de acotar el problema es comparar provisionalmente la ruta con el árbol de carpetas: si 2026-09-30.md está en Diary/2026/, ../images/blue-mug.jpg debería resolverse en Diary/images/blue-mug.jpg. Si la ruta llega a la carpeta correcta pero el archivo se llama Blue-Mug.JPG, actualiza la referencia en el texto o el nombre del archivo para que coincidan con exactitud. Si la imagen se abre en el explorador de archivos pero no se renderiza en la nota, el inconveniente restante puede radicar en cómo gestiona ese visor las rutas locales de Markdown; compruébalo en su documentación o prueba con un destino de imagen estándar de Markdown.

Sección 7

Una regla sencilla de portabilidad

Conserva las imágenes locales dentro de la carpeta principal del diario, escribe la ruta de cada imagen de forma relativa a la nota que la muestra y preserva la estructura de carpetas al mover el diario. Por último, abre la copia trasladada en tu visor real y confirma que se muestren imágenes representativas. Esa rutina comprueba conjuntamente la relación entre archivos y el comportamiento de la aplicación, que es lo que hace que una configuración portátil resulte fiable en el uso cotidiano.

Lecturas relacionadas

Sigue explorando este tema