DOCX in Markdown umwandeln

1. 1

   Word-Dokument hinzufügen

   Ziehen Sie eine DOCX-Datei auf den Uploadbereich oder wählen Sie sie über Datei wählen aus. Es werden ausschließlich Word-.docx-Dateien akzeptiert; alles andere wird sofort mit einem Hinweis abgelehnt, was stattdessen zu tun ist. Die Konvertierung startet von selbst - es gibt keinen Knopf, den Sie vorher drücken müssten.

2. 2

   Aussehen des Markdowns wählen

   Wählen Sie eine Markdown-Variante: GitHub Flavored Markdown für Repositories und die meisten statischen Seiten, CommonMark für strikte Parser oder Pandoc, wenn die Ausgabe in eine Pandoc-Pipeline geht. Entscheiden Sie dann, was mit eingebetteten Bildern geschieht, ob YAML-Front-Matter ergänzt wird, ob Überschriften herabgestuft werden und ob lange Zeilen umbrechen.

3. 3

   In der Vorschau prüfen

   Wechseln Sie zwischen Quelltext und Gerendert. Der Quelltext zeigt genau das Markdown, das Sie mitnehmen; Gerendert zeigt, wie es aussieht, sobald ein Markdown-Renderer es gelesen hat - so prüfen Sie Tabellen, Listen und Links, bevor Sie sich auf das Ergebnis festlegen.

4. 4

   Kopieren oder herunterladen

   Mit Kopieren landet das Markdown in der Zwischenablage, mit Herunterladen speichern Sie eine .md-Datei. Enthielt das Dokument Bilder, laden Sie stattdessen das ZIP: es enthält die .md-Datei und einen images-Ordner, dessen Dateien zu den Pfaden im Markdown passen. Alles läuft auf Ihrem Gerät, kein Dokument wird jemals hochgeladen.

Jeder Teil eines Word-Dokuments, der eine Markdown-Entsprechung hat, wird übernommen - und die Teile ohne Entsprechung werden als HTML geschrieben statt stillschweigend verworfen.

• Echte Tabellen: Word-Tabellen werden zu Pipe-Tabellen, mit aus dem Dokument gelesener statt geratener Spaltenausrichtung.
• Fußnoten und Endnoten: Beide werden zu [^1]-Referenzen, deren Definitionen am Dateiende gesammelt werden.
• Vollständige Inline-Formatierung: Fett, Kursiv, Durchgestrichen, Unterstrichen, Hervorhebung, Hoch- und Tiefstellung, Inline-Code und Links bleiben erhalten.
• Bildextraktion: Eingebettete Bilder wandern in einen images-Ordner und werden mit dem Markdown als ein ZIP geliefert.
• YAML-Front-Matter: Titel, Autor, Thema, Schlagwörter und Datumsangaben aus dem Dokument werden zu einem Front-Matter-Block.
• Drei Markdown-Varianten: GitHub Flavored Markdown, CommonMark und Pandoc - jeweils mit der Syntax, die diese Variante wirklich unterstützt.
• Gerenderte Vorschau: Wechseln Sie zwischen Markdown-Quelltext und Darstellung, bevor Sie etwas kopieren oder herunterladen.
• Stapel mit einem Archiv: Konvertieren Sie viele Dokumente und nehmen Sie sie als ein einziges ZIP mit, statt jeweils einen Speicherdialog zu bestätigen.

Struktur ist der Teil eines Word-Dokuments, der am leichtesten verloren geht und dessen Verlust man am schwersten bemerkt. Ein Konverter, der eine Tabelle zu losen Absätzen plättet, liefert Ausgaben, die auf den ersten Blick in Ordnung wirken und auf eine Weise falsch sind, die Sie erst nach dem Einfügen bemerken. Dieses Werkzeug behandelt Struktur als das, was konvertiert wird.

Wie aus einer Word-Tabelle Markdown wird

• Kopfzeilen: Eine von Word als Wiederholungskopfzeile markierte Zeile wird zum Tabellenkopf. Ist keine markiert, wird die erste Zeile verwendet - denn genau das ist die erste Zeile einer Word-Tabelle fast immer.
• Spaltenausrichtung: Links, zentriert und rechts werden aus der Absatzausrichtung des Dokuments gelesen und als ---, :---: und ---: geschrieben.
• Pipes in Zellen: Eine Zelle mit einem Pipe-Zeichen wird maskiert, damit sie die Spalte nicht in zwei teilt.
• Zellen mit mehreren Absätzen: Zwei Absätze in einer Zelle werden mit einem Zeilenumbruch verbunden - das erhält die Pipe-Tabelle, statt die ganze Tabelle nach HTML zu zwingen.
• Verbundene Zellen: Markdown kann verbundene Zellen nicht ausdrücken, daher werden solche Tabellen als HTML geschrieben - von jedem Markdown-Renderer akzeptiert und verlustfrei.
• Verschachtelte Listen: Die Verschachtelung bleibt in beliebiger Tiefe erhalten, eingerückt so, wie CommonMark es verlangt.

Das Wort Markdown umfasst mehrere Dialekte, die sich tatsächlich unterscheiden - und die falsche Wahl liefert eine Datei voller verirrter Satzzeichen statt Formatierung. Die Varianten-Einstellung ändert die ausgegebene Syntax, nicht nur eine Beschriftung.

Welche sollten Sie wählen?

• GitHub Flavored Markdown: Die Voreinstellung und die richtige Antwort für GitHub, GitLab, Wikis und die meisten Static-Site-Generatoren. Pipe-Tabellen, ~~Durchgestrichenes~~ und [^1]-Fußnoten stehen zur Verfügung.
• CommonMark: Die strikte Grundlage. Ganz ohne Syntax für Tabellen, Durchgestrichenes und Fußnoten - diese werden als HTML geschrieben, was überall korrekt dargestellt wird, statt wörtliche Tilden und Pipes zu zeigen.
• Pandoc: Ergänzt Pandocs eigene Syntax für ^Hochstellung^ und ~Tiefstellung~. Wählen Sie sie, wenn das Markdown in eine Pandoc-Pipeline geht, die diese liest.

Ein Word-Dokument enthält meist mehr als Text. Wohin diese Zusätze gehen, hängt davon ab, was Sie mit dem Markdown vorhaben - deshalb ist es eine Einstellung und keine Annahme.

Drei Wege für eingebettete Bilder

• In einen Ordner extrahieren: Jedes Bild wird als images/image-1.png geschrieben und über diesen relativen Pfad referenziert. Der Download wird zu einem ZIP mit .md-Datei und Ordner, bereit für ein Repository.
• Inline einbetten: Jedes Bild wird zu einer Data-URI im Markdown selbst. Die Datei ist in sich geschlossen und deutlich größer - passend, um einen kurzen Ausschnitt dort einzufügen, wo keine Dateien liegen können.
• Weglassen: Gar keine Bildreferenzen - für eine Migration, bei der die Bilder bereits irgendwo liegen und nur der Text umziehen muss.

Was in die Front-Matter kommt

• Titel, Autor und Thema aus den von Word gespeicherten Dokumenteigenschaften - nicht aus dem Text erraten.
• Schlagwörter, bei mehr als einem in eine YAML-Liste aufgeteilt.
• Erstellungs- und Änderungsdatum in der ISO-Form, die Static-Site-Generatoren erwarten.
• Jeder Wert wird dort in Anführungszeichen gesetzt, wo es nötig ist - ein Titel mit Doppelpunkt kann den Seiten-Build, der ihn liest, nicht zerstören.

Die Konvertierung von Word zu Markdown ermöglicht Versionskontrolle, schafft entwicklerfreundliche Inhalte, erleichtert Dokumentation, erlaubt GitHub-Veröffentlichung und bereitet Dokumente für technisches Schreiben auf.

Vorteile des Markdown-Formats

• Versionskontrolle: Markdown ist reiner Text, ein Diff zeigt also die tatsächliche Änderung statt eines Binärklumpens.
• Entwicklerfreundlich: Es liegt neben dem Code, den es dokumentiert, und braucht keinen Spezialeditor.
• GitHub-Veröffentlichung: README- und Wiki-Inhalte werden auf GitHub und GitLab nativ dargestellt.
• Technisches Schreiben: Docs-as-Code-Toolchains nehmen Markdown als Eingabeformat.
• Einfache Formatierung: Die Syntax ist klein genug, um als reiner Text lesbar und ohne Werkzeugleiste schreibbar zu sein.

Die Konvertierung läuft in zwei Stufen, und wer weiß, welche welche ist, versteht, warum eine Einstellungsänderung sofort wirkt, die erste Konvertierung aber einen Moment braucht.

Ablauf der Konvertierung

• Dokument lesen: Die .docx wird auf Ihrem Gerät geöffnet, Struktur, Formatvorlagen, Bilder und Eigenschaften werden ausgelesen. Das ist der zeitaufwendige Teil, und er passiert einmal pro Datei.
• Markdown schreiben: Die Struktur wird gemäß Variante und übrigen Einstellungen in Markdown umgesetzt. Reine Textarbeit, also praktisch sofort.
• Einstellung ändern: Nur die zweite Stufe läuft erneut. Deshalb aktualisiert sich die Vorschau, sobald Sie einen Regler berühren - auch bei sehr langen Dokumenten.
• Stapel: Jedes Dokument wird unabhängig gelesen und geschrieben, und jedes Ergebnis lässt sich kopieren, einzeln herunterladen oder in einem Archiv sammeln.

Diese Fakten helfen Ihnen, bessere Konvertierungsentscheidungen zu treffen.

Wichtige Kennzahlen

• Ein Dokument mit 25.000 Wörtern und 50 Tabellen wird in rund 22 Millisekunden gelesen und bei einer Einstellungsänderung in unter einer Millisekunde neu gerendert.
• Akzeptiert wird ausschließlich .docx. Das ältere binäre .doc-Format wird mit einer Erklärung abgelehnt, weil es ein anderes Format ist, das Word für Sie umwandeln kann.
• Kostenlos gilt für ein Dokument nach dem anderen bis 50 MB, mit allen Konvertierungsfunktionen; Pro deckt Stapel bis 50 Dokumente ab.
• Maskierung bleibt minimal: Zeichen, die Markdown beginnen könnten, werden maskiert - Zeichen, die das nicht können, bleiben genau so, wie sie waren.
• Überschriften, Listen, Links, Hervorhebungen, Tabellen, Fußnoten und Bilder bleiben erhalten.

Konvertiert ein Dokument mit 25.000 Wörtern und 50 Tabellen in deutlich unter einer Sekunde - auf Ihrem Gerät.

Diese Hinweise führen zu optimalen Ergebnissen bei der Word-zu-Markdown-Konvertierung.

Qualitätsaspekte

• Verwenden Sie Words eingebaute Überschriften-Formatvorlagen statt manuell vergrößerten Fettdrucks - ein Konverter erkennt nur, was als Überschrift ausgezeichnet ist.
• Prüfen Sie vor dem Herunterladen den Reiter Gerendert, besonders bei Dokumenten mit Tabellen, um die Struktur zu bestätigen.
• Soll das Markdown unter einen vorhandenen Titel, stufen Sie die Überschriften um eine Ebene herab, damit das Dokument genau eine oberste Ebene hat.
• Wählen Sie CommonMark nur, wenn ein strikter Parser es verlangt; die HTML-Rückfälle sind korrekt, aber ausführlicher.
• Testen Sie die .md-Datei nach dem Herunterladen an ihrem Ziel - GitHub, statische Seite, Wiki.

Häufige Anwendungsfälle

• Dokumentation: Ein vorhandenes Word-Handbuch in ein Docs-as-Code-Repository überführen, ohne es abzutippen.
• GitHub-Veröffentlichung: Aus einer Spezifikation oder einem Vorschlag eine README- oder Wiki-Seite machen.
• Technisches Schreiben: In Word verfasste Entwürfe in eine Markdown-Toolchain für Review und Versionskontrolle bringen.
• Blogbeiträge: Einen geschriebenen Entwurf in einen Beitrag für einen Static-Site-Generator umwandeln, Front-Matter inklusive.
• Entwicklerinhalte: Tabellen und codeähnliche Inhalte aus einer Word-Spezifikation in eine diffbare Form bringen.

• Word zu PDF
• Word zu HTML
• Word-Viewer
• Word zu Text
• Word komprimieren
• CSV zu Markdown