De docx a Obsidian: las rutas de imágenes bien resueltas
El texto se convierte sin problemas entre Word y Markdown. Las imágenes son donde las migraciones se rompen: en cuanto un archivo convertido entra en un vault, cada captura de pantalla tiene que ser un archivo real en el disco, con una ruta que Obsidian pueda resolver desde la ubicación de esa nota. Resuelve primero la canalización de imágenes y todo lo demás es rutina.
Esta guía explica cómo Pandoc extrae los medios de un archivo docx, qué acaba en el disco y un flujo de trabajo repetible que termina con una nota de Obsidian funcional, además de las dos trampas clásicas: nombres de imagen que colisionan entre documentos y formatos vectoriales de Windows que Obsidian no puede mostrar.
Por qué las imágenes son la parte difícil
Un archivo docx es un archivo comprimido ZIP. Los párrafos viven en XML, pero cada captura, gráfico y diagrama se guarda en una carpeta de medios dentro de ese archivo, referenciada mediante relaciones internas y no mediante rutas del sistema de archivos. Nada de lo que ves en Word se corresponde con lo que un archivo Markdown necesita después, así que un conversor tiene que reescribir el texto y desempaquetar los binarios al mismo tiempo.
Omite la mitad del desempaquetado y obtendrás una nota llena de enlaces que no apuntan a ninguna parte. Obsidian renderiza los marcadores rotos sin quejarse, y el daño suele aparecer semanas después, cuando abres la nota en otro dispositivo o compartes el vault con un colega. Planificar la canalización de imágenes antes de convertir es lo que separa una migración limpia de un trabajo de reparación.
Cómo extrae Pandoc los medios
Pandoc, el motor detrás del conversor de este sitio, gestiona la extracción dentro de su lector de docx. Con la extracción de medios activada, cada imagen incrustada se escribe en el disco con el nombre que llevaba en el paquete: image1.png, image2.jpeg, y así sucesivamente, reunidas en una carpeta media junto al documento convertido.
La salida Markdown referencia exactamente esas rutas, de modo que la nota y su carpeta de medios viajan como un conjunto. Descarga el resultado como ZIP y recibirás ambas cosas a la vez: el archivo .md más cada imagen que menciona. Descomprime el archivo en cualquier lugar y los enlaces ya son correctos, porque las referencias son relativas a la nota.
Hay dos detalles que conviene saber. Los nombres provienen del paquete docx, no de tus leyendas, así que una foto etiquetada como Survey Site B puede acabar como image7.png. Y la numeración se reinicia por documento: cada archivo de Word vuelve a empezar en image1, lo que se convierte en un problema de colisiones en cuanto varios documentos convertidos comparten una carpeta.
Base64 en línea o una carpeta separada
El modo Base64 adopta el enfoque contrario: las imágenes se incrustan directamente en el Markdown como data URIs en lugar de escribirse en el disco. El resultado es un único archivo autocontenido sin carpeta de medios que perder, lo que resulta cómodo cuando una nota tiene que viajar como un único adjunto o sobrevivir a copias entre herramientas.
Para un vault, los archivos reales suelen ganar. Los data URIs inflan el tamaño alrededor de un tercio, y unas pocas capturas pueden convertir una nota en varios megabytes de texto base64 que ralentizan el editor y vuelven inútiles los diffs y el control de versiones. Los archivos reales además pueden comprimirse o renombrarse una sola vez, corrigiendo todas las notas que los referencian; los datos de imagen congelados dentro de una nota nunca pueden actualizarse en un solo lugar.
Las convenciones de adjuntos de Obsidian
Obsidian te permite elegir la estructura, y hay dos ajustes que importan aquí. En Files and links (Archivos y enlaces), Default location for new attachments (Ubicación predeterminada de los nuevos adjuntos) decide adónde van las imágenes que sueltas: la raíz del vault, la carpeta actual o una carpeta que tú indiques. La mayoría de los vaults acaban convergiendo en una única carpeta de adjuntos para todo el vault.
El Markdown convertido llega con referencias relativas como media/image1.png, que Obsidian resuelve respecto a la ubicación de la propia nota, así que la colocación es sencilla al principio: mantén la carpeta media junto a la nota. New link format (Formato de enlace nuevo) controla lo que Obsidian escribirá en adelante, y las rutas relativas son la opción más segura porque las notas siguen funcionando cuando el vault se mueve entre equipos o herramientas de sincronización.
Un flujo de trabajo que funciona a la primera
Primero, suelta el docx en el conversor de este sitio y mantén el modo de imágenes en ZIP. La conversión se ejecuta por completo en tu navegador, así que los borradores sin publicar nunca salen del equipo, y la descarga contiene el archivo .md más su carpeta de medios, ya conectados con rutas relativas.
Segundo, descomprime el ZIP en la carpeta del vault donde debe vivir la nota, manteniendo el .md y la carpeta media uno al lado del otro. Abre el vault y las imágenes se renderizarán al primer intento, porque cada referencia apunta a un archivo que realmente existe a un nivel de distancia.
Tercero, ordena desde dentro de Obsidian, no desde el gestor de archivos. Selecciona una imagen, arrástrala a tu carpeta de adjuntos y Obsidian mueve el archivo y reescribe la referencia en la misma acción. Mover archivos fuera de la aplicación deja enlaces obsoletos, porque nada vuelve a escanear las rutas que cambiaron a sus espaldas.
Cuando los documentos colisionan
Cada documento de Word numera sus imágenes desde uno, así que diez trabajos convertidos contienen diez archivos image1.png distintos. Cópialos todos en una carpeta de adjuntos compartida y habrás sobrescrito nueve de ellos sin darte cuenta. Esta es la forma más común de que una migración parezca terminada y luego pierda figuras semanas después, mucho después de que alguien recuerde qué archivo venía de dónde.
La conversión por lotes evita esto dando a cada documento de origen su propio subdirectorio dentro del ZIP: una nota con su carpeta de medios, luego la siguiente, sin espacio de nombres compartido entre ellas. Si de verdad quieres una única carpeta de adjuntos para todo el vault, fusiona de forma deliberada: renombra las imágenes de cada documento con un prefijo significativo y luego busca y reemplaza las rutas antiguas en el Markdown.
Formatos que Obsidian no puede renderizar
No todo lo que hay en un docx es un PNG o un JPEG. Los diagramas de Office, los pegados de Visio y algunas operaciones de copiado producen EMF y WMF, formatos vectoriales de Windows que los navegadores no pueden decodificar. Como Obsidian está construido sobre tecnología de navegador, esas imágenes permanecen invisibles por muy correctas que sean las rutas, dejando a menudo un hueco con forma de figura en la nota.
Tras descomprimir, ordena la carpeta de medios por tipo de archivo y aparta todo lo que termine en .emf o .wmf. La solución más barata es volver al documento de origen, hacer clic con el botón derecho en la figura y elegir Save as picture (Guardar como imagen) para exportar un PNG antes de convertir. Después, renombra la exportación para que coincida con la referencia, o edita la referencia para que coincida con el archivo.