UltKit

DOCX in Markdown umwandeln

Wer Dokumentation aus Word in ein Git-Repository überführen will, wandelt zuerst jede .docx in Markdown um. Dieser Konverter erzeugt Text im CommonMark-Stil mit #-Überschriften, Pipe-Tabellen und Bildlinks, bereit zum Committen.

Dokument-Konverter

oder PDF, DOC, DOCX …-Dateien hierher ziehen ·

Max. 95 MB pro Datei· Bis zu 20 Dateien· Gelöscht nach 30 Minuten

Ausgabe

Dateien werden auf unseren Servern verarbeitet und nach 30 Minuten gelöscht.

So verwenden Sie dieses Tool

  1. 1

    Word-Dateien hochladen

    Fügen Sie bis zu 20 .docx- oder .doc-Dateien mit jeweils bis zu 95 MB hinzu. Nehmen Sie Änderungen mit Nachverfolgung vorher in Word an oder lehnen Sie sie ab, denn Markdown kann sie nicht darstellen.

  2. 2

    Textoptionen prüfen

    Formatierung steht auf Einfach, Textkodierung auf UTF-8 und Zeilenenden auf LF – die Kombination, die Git und Generatoren für statische Websites erwarten. Lassen Sie Bilder einschließen aktiviert, damit die Bilder in einem Ordner landen.

  3. 3

    Umwandeln und entpacken

    Klicken Sie auf In MD umwandeln. Jedes Dokument kommt als ZIP mit der .md-Datei und ihren Bildern; entpacken Sie es in Ihren Docs-Ordner und committen Sie es.

Antwort

Wie wandle ich ein Word-Dokument in Markdown um?

Laden Sie die .docx-Datei hoch und klicken Sie auf In MD umwandeln. Sie erhalten eine .md-Datei mit #-Überschriften, Listen, Links und Tabellen, dazu die Bilder in einem Ordner daneben – alles in einem ZIP.

DOCX in Markdown für Docs-as-Code

Teams setzen auf Docs-as-Code aus einem Grund: Die Dokumentation liegt dann neben dem Code, durchläuft dieselben Pull Requests und wird mit demselben Release ausgeliefert. Eine .docx-Datei verhindert das, denn sie ist ein ZIP aus XML-Teilen, das Git als undurchsichtige Binärdatei speichert. Eine Änderung von einem Wort erscheint als geänderte Datei ohne lesbaren Diff, und zwei Personen, die gleichzeitig arbeiten, können ihre Änderungen nicht zusammenführen.

Markdown ist reiner Text, daher ist jede Änderung eine sichtbare Zeilenänderung. Außerdem wurde es 2014 deutlich berechenbarer, als John MacFarlane und andere CommonMark veröffentlichten, eine präzise Spezifikation der Syntax, die Gruber zehn Jahre zuvor nur lose beschrieben hatte. GitHub stützte 2017 seine eigene Spezifikation, GitHub Flavored Markdown, auf CommonMark und ergänzte Pipe-Tabellen, Aufgabenlisten und Durchstreichen, die heute in den meisten READMEs vorkommen.

Wenn Ihr Inhalt in die andere Richtung soll, also Markdown an eine Prüferin oder einen Prüfer, die in Word arbeiten, nutzen Sie Markdown in DOCX. Für eine Webseite statt eines Repositorys behält DOCX in HTML mehr vom Layout bei.

So sieht die Markdown-Ausgabe aus

Ein Word-Abschnitt mit Überschrift, Liste und Tabelle nach der Umwandlung
## Release-Checkliste

Bestätigen Sie vor dem Taggen eines Releases Folgendes:

- Tests laufen auf **main** durch
- Das Changelog führt jeden gemergten PR auf

| Schritt | Verantwortlich |
| --- | --- |
| Build | CI |
| Veröffentlichen | Maintainer |

![Release-Ablauf](images/figure-1.png)

Wo das umgewandelte Markdown dargestellt wird

Plattformen, die Markdown-Dateien direkt lesen
OrganisationAnforderungQuelle
GitHubStellt README.md und jede .md-Datei in einem Repository mit GitHub Flavored Markdown dargithub.com
HugoErzeugt Seiten aus .md-Inhaltsdateien mit einem CommonMark-konformen Parsergohugo.io
JekyllMacht aus .md-Dateien mit Front Matter Seiten; die Engine hinter GitHub Pagesjekyllrb.com
DocusaurusLiest .md- und .mdx-Dateien in seinem Docs-Ordner als Dokumentationsseitendocusaurus.io

DOCX

Microsoft-Word-Dokument

DOCX ist seit Office 2007 das Standarddokumentformat von Microsoft Word und basiert auf dem Standard Office Open XML (ECMA-376, ISO/IEC 29500). Es ist ein ZIP-Paket aus XML-Dateien mit Text, Formatvorlagen, Bildern, Tabellen, Kommentaren und nachverfolgten Änderungen. Es ist das gängigste Format für bearbeitbare Dokumente in Büros, Schulen und Bewerbungen. Das Layout kann sich zwischen Word, Google Docs, LibreOffice und Pages leicht verschieben, besonders bei komplexer Formatierung. Die meisten Textverarbeitungen öffnen DOCX-Dateien.

Komprimierung
–
Transparenz
–
Animation
–
Eingeführt
2007 · Microsoft
DOCX-Konverter

MD

Markdown

Markdown ist eine schlanke Auszeichnungssyntax, die John Gruber 2004 entwickelt hat. Sie nutzt Klartextzeichen wie # für Überschriften, * für Hervorhebung und - für Listen, die als Rohtext lesbar bleiben und sich sauber in HTML umwandeln lassen. Sie ist der Standard für README-Dateien, Dokumentation, Wikis, Notiz-Apps und viele Generatoren für statische Websites. Es gibt mehrere Dialekte wie CommonMark und GitHub Flavored Markdown, die sich in Details wie Tabellen unterscheiden. Jeder Texteditor kann .md-Dateien öffnen.

Komprimierung
–
Transparenz
–
Animation
–
Eingeführt
2004 · John Gruber
MD-Konverter

DOCX wird in Markdown umgewandelt, wenn ein Dokument in einen Code-Workflow wechselt: ein README, eine Dokumentationsseite oder eine Wissensdatenbank in Git, wo sich reiner Text vergleichen, in Pull Requests prüfen und mit vielen Tools darstellen lässt.

Word-Funktionen ohne Entsprechung in Markdown

Das sollten Sie vor dem Umwandeln einplanen

  • Schriftarten, Farben und Seitenlayout entfallen; Markdown beschreibt die Struktur, das Aussehen bestimmt das Theme der Website
  • Änderungen mit Nachverfolgung und Kommentare werden nicht übernommen, klären Sie sie daher zuerst in Word
  • Kopfzeilen, Fußzeilen und Seitenzahlen haben in einer .md-Datei keinen Platz
  • Textfelder und umflossene Bilder werden zu normalen Absätzen und Bildlinks
  • Von Hand formatierte Überschriften, etwa fett in 16 pt statt Überschrift 2, werden zu fettem Text; wenden Sie daher vorher echte Überschriftenformate an
  • Unterstreichung hat keine Markdown-Syntax und wird entfernt oder als HTML beibehalten

Fragen zur Umwandlung von DOCX in Markdown

Welcher Markdown-Variante folgt die Umwandlung von DOCX in MD?

Überschriften, Hervorhebungen, Listen, Links und Code folgen CommonMark, Tabellen verwenden die Pipe-Syntax aus GitHub Flavored Markdown. GitHub, GitLab, Hugo, Jekyll und Docusaurus stellen diese Kombination alle dar.

Was passiert mit verbundenen Tabellenzellen?

Markdown-Pipe-Tabellen kennen keine verbundenen Zellen. Jeder verbundene Bereich wird daher wieder in einzelne Zellen aufgeteilt, der Text steht in der ersten. Bauen Sie komplexe Tabellen als HTML in der .md-Datei nach oder vereinfachen Sie sie vor der Umwandlung in Word.

Wo landen die Bilder aus meinem Word-Dokument?

Bei aktivierter Option Bilder einschließen wird jedes Bild als eigene Datei im ZIP gespeichert, und das Markdown verweist per relativem Pfad darauf, z. B. images/figure-1.png. Lassen Sie den Ordner beim Verschieben neben der .md-Datei liegen.

Bleiben Word-Fußnoten in Markdown erhalten?

CommonMark kennt keine Fußnoten-Syntax, doch GitHub hat 2021 Fußnoten mit [^1] ergänzt, und die meisten Generatoren unterstützen sie. Falls Ihr Renderer das nicht tut, erscheint der Fußnotentext als normale Absätze am Ende.

Kann ich auf diese Weise Google Docs in Markdown umwandeln?

Ja. Wählen Sie in Google Docs Datei > Herunterladen > Microsoft Word (.docx) und laden Sie diese Datei hier hoch. Google Docs bietet auch einen eigenen Markdown-Download an, der für einfache Dokumente gut funktioniert.