Von Word zu Markdown migrieren: der vollständige Leitfaden
Die Migration von Dokumenten von Word zu Markdown ist größtenteils mechanisch, doch die Fehler sind vorhersehbar und lassen sich günstig vermeiden. Jeder einzelne geht darauf zurück, dass die Konvertierung als ein einziger magischer Schritt behandelt wird statt als kleine Pipeline mit ein paar Entscheidungen.
Dieser Leitfaden geht diese Entscheidungen der Reihe nach durch: wie viel Sie tatsächlich migrieren, was die Konvertierung überlebt und was nicht, wie Fußnoten, Tabellen und Formeln reisen, und wie Sie mit einer Datei abschließen, die Ihre statische Website oder Ihr Wiki beim ersten Versuch akzeptiert.
Legen Sie den Umfang vor der Konvertierung fest
Ein einzelnes aktives Dokument und ein zehn Jahre altes Archiv sind zwei verschiedene Projekte. Bei einem Dokument ist das Ziel eine getreue Konvertierung, die Sie an einem Nachmittag von Hand nachpolieren. Bei einem Archiv verschiebt sich das Ziel auf Wiederholbarkeit: ein Satz Optionen, konsequent angewendet, wobei Menschen eine Stichprobe prüfen statt jede Datei.
Beginnen Sie in beiden Fällen mit einer Stichprobe. Konvertieren Sie zwei oder drei repräsentative Dokumente – die mit den schlimmsten Tabellen und den meisten Abbildungen – und prüfen Sie das Ergebnis genau. Die Stichprobe zeigt Ihnen, welche Optionen wichtig sind und wie viel Nacharbeit der Rest des Stapels braucht, bevor Sie den vollständigen Lauf starten.
Was sauber konvertiert wird – und was nicht
Echte Word-Formatvorlagen für Überschriften werden zu Markdown-Überschriften, einfache Tabellen zu Tabellen, Fußnoten zu Fußnoten, und eingebettete Bilder werden als echte Dateien extrahiert. Inhalte im normalen Dokumentfluss übertragen sich gut – und das ist das meiste, aus dem ein typisches Dokument tatsächlich besteht.
Die Ausnahmen sammeln sich an den Rändern. Direkt angewendete Formatierung, etwa fette Zeilen, die Überschriften vortäuschen, wird nicht zu Struktur – wenden Sie also zuerst echte Überschriften-Formatvorlagen in Word an. Die Änderungsverfolgung (Tracked Changes) wird so konvertiert, als wäre jede Änderung angenommen; klären Sie Revisionen vor der Konvertierung, wenn Ihnen der gelöschte Text wichtig ist. Kommentare, Textfelder und schwebende Formen werden nicht zuverlässig übernommen; deren Inhalte sollten in den Hauptfluss verschoben oder separat gesichert werden.
Fußnoten reisen mit
Word-Fußnoten sind eine der angenehmen Überraschungen. Pandoc liest sie, und die Markdown-Ausgabe nutzt echte Fußnotensyntax: Jede Markierung im Text wird zu einer Referenz in eckigen Klammern mit Caret-Zeichen vor der Nummer, und alle Definitionen sammeln sich am Dokumentende, zurückverlinkt zu ihren Markierungen.
Zwei Dinge verdienen trotzdem eine Prüfung. Fußnoten, die einander referenzieren oder Tabellen bzw. Bilder enthalten, können in anderer Reihenfolge oder Form herauskommen als im Original. Und Endnoten werden genauso konvertiert wie Fußnoten – was in Markdown meist genau das ist, was Sie wollen.
Tabellen und ihre Grenzen
Aktivieren Sie die GFM-Option, wenn das Ziel GitHub, Obsidian oder die meisten Wikis ist: Einfache Tabellen werden zu Pipe-Tabellen – eine Kopfzeile, eine Trennzeile und eine Zeile pro Datenzeile. Dieses Format rendert überall und bleibt als Klartext lesbar.
Die Grenze ist strukturell. Verbundene Zellen, Zellen mit mehreren Absätzen und verschachtelte Tabellen haben keine Pipe-Tabellen-Darstellung, und Pandoc fällt auf Markdown-Dialekte zurück, die diese Plattformen ignorieren. Die ehrliche Lösung liegt vorgelagert: Lösen Sie komplizierte Tabellen in Word auf und flachen Sie sie ab – oder akzeptieren Sie, dass einige Tabellen nach der Migration manuelle Nacharbeit brauchen.
Mathematik wird zu LaTeX
Mit dem Formel-Editor von Word eingegebene Gleichungen werden als strukturierte Mathematik gespeichert, und Pandoc konvertiert sie statt sie zu verwerfen. Die Markdown-Ausgabe umschließt Inline-Formeln mit Dollarzeichen und setzt abgesetzte Gleichungen auf eigene Zeilen; das LaTeX-Ausgabeformat erzeugt native Mathematik-Umgebungen für Render-Pipelines, die sie erwarten.
Suchen Sie nach der Konvertierung nach den zwei Schwachstellen: Inline-Formeln, die Word mehrdeutig anzeigte, und alles, was vor Jahren als Bild in Word eingefügt wurde – das ist jetzt ein Bild, keine Mathematik. Diese müssen neu eingegeben werden; das vor Migrationsbeginn zu wissen, hält den Zeitplan ehrlich.
Eine vorhersehbare Bildstrategie
Jedes eingebettete Bild wird in einen media-Ordner neben der konvertierten Datei extrahiert, mit den Namen, die das docx-Paket vergeben hat: image1.png und seine Geschwister. Das Markdown referenziert diese relativen Pfade, und ein ZIP-Download liefert beides zusammen – jedes konvertierte Dokument bleibt ein in sich geschlossenes Paar.
Entscheiden Sie vor dem Lauf, ob Dokumente ihre eigenen media-Ordner behalten oder in einem gemeinsamen assets-Ordner zusammenlaufen. Getrennt zu bleiben ist sicher und automatisch; Zusammenführen erfordert Umbenennen mit sinnvollen Präfixen und das Anpassen der Referenzen. Vermeiden sollten Sie, die Kollision erst zu entdecken, nachdem sich mehrere image1.png-Dateien bereits gegenseitig überschrieben haben.
Front Matter für Ihre statische Website
Statische Site-Generatoren wie Hugo und Jekyll erwarten YAML Front Matter am Anfang jeder Datei: title, author, date. Der Konverter kann diesen Block aus den im docx gespeicherten Dokumenteigenschaften erzeugen – die Dateien kommen also bereits mit Metadaten an, statt dass diese nachträglich getippt werden müssen.
Das funktioniert nur, wenn die Eigenschaften echt sind. Word-Dateien, die en gros aus älteren Formaten konvertiert wurden, haben oft ein leeres Title-Feld und als Ersteller das Konto eines ehemaligen Mitarbeiters. Zehn Minuten in Word vor dem Lauf – Dateiinformationen für jedes Dokument ausfüllen – sind der Unterschied zwischen brauchbarem Front Matter und Platzhaltern.
Der Batch-Migrationsdurchlauf
Sobald die Optionen an der Stichprobe kalibriert sind, verläuft der Massenlauf ereignislos. Fügen Sie dem Konverter auf dieser Website den Ordner mit den docx-Dateien hinzu, lassen Sie die Warteschlange jede Datei mit eigenem Status verarbeiten und laden Sie das ZIP herunter. Die Batch-Ausgabe gibt jedem Dokument ein eigenes Unterverzeichnis, sodass Bilder einer Arbeit nie die Bilder einer anderen verdecken.
Bewahren Sie die Original-docx-Dateien auf, bis die Migration abgenommen ist. Sie sind die Quelle der Wahrheit für alles, was die Konvertierung geglättet oder fallen gelassen hat, und ein erneuter Lauf mit angepassten Optionen ist immer billiger, als ein verlorenes Detail aus dem Gedächtnis zu rekonstruieren.
Eine Checkliste für die fertige Migration
Prüfen Sie für jedes Dokument sechs Dinge: Die Überschriftenhierarchie steigt ohne Sprünge ab, jede Bildreferenz löst zu einer existierenden Datei auf, Tabellen rendern auf der Zielplattform, Fußnoten erscheinen als echte Fußnoten, Mathematik rendert, wo sie soll, und Front-Matter-Felder sind gefüllt statt leer.
Zum Schluss führen Sie ein Dokument im echten Ziel von Anfang bis Ende aus: Bauen Sie die statische Website, zeigen Sie die Wiki-Seite in der Vorschau, öffnen Sie die Notiz in Obsidian. Eine Migration ist fertig, wenn das Zielsystem die Dateien rendert – nicht, wenn der Konverter Erfolg meldet. Diese letzte Prüfung dauert Minuten und fängt alles ab, was die Prüfungen auf Dateiebene übersehen haben.