Von docx zu Obsidian: Bildpfade richtig einrichten
Text lässt sich sauber zwischen Word und Markdown konvertieren. Bei Bildern scheitern Migrationen: Sobald eine konvertierte Datei in einem Vault landet, muss jeder Screenshot eine echte Datei auf der Festplatte sein, deren Pfad Obsidian vom Speicherort der Notiz aus auflösen kann. Klären Sie zuerst die Bild-Pipeline, und alles Weitere ist Routine.
Diese Anleitung erklärt, wie Pandoc Medien aus einer docx-Datei extrahiert, was auf der Festplatte landet, und beschreibt einen wiederholbaren Workflow, der mit einer funktionierenden Obsidian-Notiz endet – plus die zwei klassischen Fallen: kollidierende Bildnamen über Dokumente hinweg und Windows-Vektorformate, die Obsidian nicht anzeigen kann.
Warum Bilder der schwierige Teil sind
Eine docx-Datei ist ein ZIP-Archiv. Die Absätze stehen im XML, aber jeder Screenshot, jedes Diagramm und jede Grafik liegt in einem Medienordner innerhalb dieses Archivs, referenziert über interne Beziehungen statt über Dateisystempfade. Nichts von dem, was Sie in Word sehen, entspricht dem, was eine Markdown-Datei danach braucht – ein Konverter muss also gleichzeitig Text umschreiben und Binärdaten entpacken.
Lassen Sie das Entpacken weg, erhalten Sie eine Notiz voller Links, die ins Leere zeigen. Obsidian rendert die defekten Platzhalter ohne Warnung, und der Schaden fällt meist Wochen später auf, wenn Sie die Notiz auf einem anderen Gerät öffnen oder den Vault mit einem Kollegen teilen. Die Bild-Pipeline vor der Konvertierung zu planen, ist der Unterschied zwischen einer sauberen Migration und einer Reparaturaktion.
Wie Pandoc Medien extrahiert
Pandoc, die Engine hinter dem Konverter auf dieser Seite, erledigt die Extraktion in seinem docx-Reader. Bei aktivierter Medienextraktion wird jedes eingebettete Bild unter dem Namen aus dem Paket auf die Festplatte geschrieben: image1.png, image2.jpeg und so weiter – gesammelt in einem media-Ordner neben dem konvertierten Dokument.
Die Markdown-Ausgabe referenziert genau diese Pfade, sodass Notiz und Medienordner als Einheit zusammenbleiben. Laden Sie das Ergebnis als ZIP herunter, erhalten Sie beides auf einmal: die .md-Datei plus jedes Bild, das sie erwähnt. Entpacken Sie das Archiv an einem beliebigen Ort, und die Links stimmen bereits, weil die Referenzen relativ zur Notiz sind.
Zwei Details sind wissenswert. Die Namen stammen aus dem docx-Paket, nicht aus Ihren Bildunterschriften – ein Foto mit der Beschriftung Survey Site B kann als image7.png landen. Und die Nummerierung beginnt pro Dokument von vorn: Jede Word-Datei startet wieder bei image1, was zum Kollisionsproblem wird, sobald mehrere konvertierte Dokumente einen Ordner teilen.
Base64 inline oder ein separater Ordner
Der Base64-Modus geht den umgekehrten Weg: Bilder werden direkt als data URIs in das Markdown eingebettet, statt auf die Festplatte geschrieben zu werden. Das Ergebnis ist eine einzige in sich geschlossene Datei ohne Medienordner, der verloren gehen könnte – praktisch, wenn eine Notiz als einzelner Anhang reisen oder das Einfügen zwischen Werkzeugen überstehen muss.
Für einen Vault gewinnen meist echte Dateien. Data URIs vergrößern das Volumen um etwa ein Drittel, und ein paar Screenshots können eine Notiz in mehrere Megabyte Base64-Text verwandeln, der den Editor träge macht und Diffs sowie Versionskontrolle nutzlos werden lässt. Echte Dateien lassen sich außerdem einmal komprimieren oder umbenennen und korrigieren damit jede Notiz, die sie referenziert; Bilddaten, die in einer Notiz eingefroren sind, können nie zentral aktualisiert werden.
Obsidians Konventionen für Anhänge
Obsidian lässt Ihnen die Wahl des Layouts, und zwei Einstellungen sind hier wichtig. Unter Files and links (Dateien und Links) entscheidet Default location for new attachments (Standardort für neue Anhänge), wohin abgelegte Bilder wandern: in das Vault-Stammverzeichnis, in den aktuellen Ordner oder in einen Ordner Ihrer Wahl. Die meisten Vaults einigen sich am Ende auf einen zentralen Anhangsordner für den gesamten Vault.
Konvertiertes Markdown kommt mit relativen Referenzen wie media/image1.png, die Obsidian gegen den Speicherort der Notiz auflöst – die Platzierung ist also zunächst einfach: Behalten Sie den media-Ordner neben der Notiz. New link format (Neues Linkformat) steuert, was Obsidian künftig schreibt, und relative Pfade sind die sicherste Wahl, weil Notizen weiterhin funktionieren, wenn der Vault zwischen Rechnern oder Synchronisierungstools wechselt.
Ein Workflow, der beim ersten Mal funktioniert
Ziehen Sie zuerst die docx-Datei in den Konverter auf dieser Seite und lassen Sie den Bildmodus auf ZIP. Die Konvertierung läuft vollständig in Ihrem Browser, unveröffentlichte Entwürfe verlassen also nie das Gerät, und der Download enthält die .md-Datei plus ihren Medienordner – bereits mit relativen Pfaden verdrahtet.
Entpacken Sie das ZIP zweitens in den Vault-Ordner, in dem die Notiz liegen soll, und halten Sie .md-Datei und media-Ordner nebeneinander. Öffnen Sie den Vault, und die Bilder werden beim ersten Versuch gerendert, weil jede Referenz auf eine Datei zeigt, die tatsächlich eine Ebene weiter existiert.
Räumen Sie drittens aus Obsidian heraus auf, nicht im Dateimanager. Wählen Sie ein Bild aus, ziehen Sie es in Ihren Anhangsordner, und Obsidian verschiebt die Datei und schreibt die Referenz in derselben Aktion um. Dateien außerhalb der App zu verschieben hinterlässt verwaiste Links, weil nichts die Pfade erneut scannt, die sich hinter seinem Rücken geändert haben.
Wenn Dokumente kollidieren
Jedes Word-Dokument nummeriert seine Bilder ab eins, sodass zehn konvertierte Arbeiten zehn verschiedene image1.png-Dateien enthalten. Kopieren Sie alle in einen gemeinsamen Anhangsordner, und Sie haben stillschweigend neun davon überschrieben. So sieht eine Migration am häufigsten fertig aus und verliert dann Wochen später Abbildungen – lange nachdem niemand mehr weiß, welche Datei woher kam.
Die Stapelkonvertierung umgeht das Problem, indem jedes Quelldokument ein eigenes Unterverzeichnis im ZIP erhält: eine Notiz mit ihrem Medienordner, dann die nächste, ohne gemeinsamen Namensraum dazwischen. Wenn Sie wirklich einen einzigen vault-weiten Anhangsordner wollen, führen Sie bewusst zusammen: Benennen Sie die Bilder jedes Dokuments mit einem sprechenden Präfix um und ersetzen Sie dann die alten Pfade im Markdown per Suchen und Ersetzen.
Formate, die Obsidian nicht rendern kann
Nicht alles in einer docx-Datei ist PNG oder JPEG. Office-Diagramme, Visio-Einfügungen und manche Kopiervorgänge erzeugen EMF und WMF – Windows-Vektorformate, die Browser nicht dekodieren können. Da Obsidian auf Browsertechnologie aufbaut, bleiben diese Bilder unsichtbar, egal wie korrekt die Pfade sind, und hinterlassen oft ein abbildungsförmiges Loch in der Notiz.
Sortieren Sie den media-Ordner nach dem Entpacken nach Dateityp und ziehen Sie alles heraus, was auf .emf oder .wmf endet. Die günstigste Lösung: Gehen Sie zurück zum Quelldokument, klicken Sie die Abbildung mit der rechten Maustaste an und wählen Sie Save as picture (Als Bild speichern), um vor der Konvertierung ein PNG zu exportieren. Benennen Sie den Export dann passend zur Referenz um – oder passen Sie die Referenz an die Datei an.