Markdown Writer

Converter

Word to Markdown, without the upload.

Drop a .docx file and get clean GitHub Flavored Markdown back. Headings, lists, tables, and links carry over. Your file is read inside this tab — it is never uploaded.

  • No signup
  • No upload
  • Tables & lists preserved
  • Works offline

Going the other way? Markdown to Word →

Local converter
docxno file

Drop a Word .docx file here

Or to choose one. It never leaves your browser.

0 words
Drop a .docx file on the left to see markdown here.

Why this converter

Your documents stay on your machine.

Most docx to markdown converters ask you to upload the file to a server you don't control. Contracts, drafts, internal docs — all of it, handed over just to convert a Word file. This one does the work in your browser instead.

  • Nothing is uploaded

    The .docx file is parsed in your browser with Mammoth. No request carries your file anywhere. Check the network panel and see for yourself.

  • Headings preserved

    Word's built-in Heading 1–6 styles map to markdown headings, and the Title and Subtitle styles map to H1 and H2.

  • Lists and tables

    Bullet and numbered lists, plus tables, convert to GitHub Flavored Markdown — the same dialect GitHub, GitLab, and this editor render.

  • Formatting kept

    Bold, italic, links, and highlighted text all carry through, so the converted markdown reads the same as the original document.

  • Loads only when needed

    The docx and markdown engines download the moment you drop a file, not before. The page itself stays light for everyone who's just reading.

  • Verify with preview

    Flip the output between markdown source and a rendered preview to confirm the conversion before you copy it.

How it works

Convert DOCX to Markdown in three steps.

  1. 01

    Drop your .docx

    Drag it onto the drop zone or browse for it. The file is read locally — it never leaves the tab.

  2. 02

    Structure is rebuilt

    Mammoth reads the document's XML into semantic HTML, then that HTML is converted to GitHub Flavored Markdown.

  3. 03

    Copy or download

    Take the markdown to your clipboard, save it as a .md file, or open it straight in the editor.

What to expect

What converts, and what doesn't.

A .docx file carries a lot more than plain text — some of it maps cleanly to markdown, and some has no markdown equivalent at all. Here's the honest split for this docx to md converter.

Converts well

  • Headings, including Title and Subtitle styles
  • Paragraphs, bold, and italic text
  • Bullet and numbered lists, including nested ones
  • Tables, as GitHub Flavored Markdown tables
  • Hyperlinks, with their visible text
  • Highlighted text, as ==markdown highlights==

Doesn't convert

  • Images are skipped rather than inlined as base64
  • Comments are dropped
  • Tracked changes are resolved as if accepted
  • Footnotes and endnotes land inline where referenced
  • Text boxes and their contents
  • Equations and embedded objects

FAQ

Common questions

Is my Word document uploaded anywhere?
No. The .docx file is read and converted entirely inside your browser tab using Mammoth, an open-source library that runs on your device. The file is never attached to a network request and never reaches a server. You can check your browser's network panel while converting, or disconnect from the internet after the page loads — the converter still works.
Is DOCX to MD the same as Word to Markdown?
.md is the file extension markdown uses, and .docx is the file format modern Word documents are saved in, so a DOCX to MD converter and a Word to Markdown converter describe the same conversion. This tool reads the .docx file's XML, rebuilds the document as HTML, and turns that into GitHub Flavored Markdown you can copy or download as a .md file.
Why won't it accept my .doc file?
Only the modern .docx format is supported — the older binary .doc format uses a completely different, proprietary file structure that the browser-based library this tool relies on can't parse. Open the file in Word (or Google Docs, or LibreOffice) and use File > Save As > Word Document (.docx), then drop the new file here.
Can I convert a Google Doc?
Yes, in one extra step. In Google Docs, go to File > Download > Microsoft Word (.docx), then drop the downloaded file onto this page. Google Docs doesn't expose its own format for direct browser conversion, but its DOCX export works the same as one saved from Word.
Do tables convert correctly?
Yes. Word tables become GitHub Flavored Markdown tables, with the first row treated as the header. Merged cells and complex nested tables don't have a markdown equivalent, so those are flattened into the closest simple table.
What happens to images in the document?
Images are skipped. This converter focuses on getting text, structure, and formatting right rather than inlining images as base64 data, which would bloat the markdown and rarely survives a round trip anyway. The surrounding text converts normally.
What about tracked changes and comments?
Comments are dropped, and tracked changes are resolved as if they'd been accepted — insertions are kept and deletions are removed. If you need a clean copy either way, accept or reject the changes in Word first, then convert.
Can I edit the markdown afterwards?
Yes. Copy it, download it as a .md file, or open it directly in the Markdown Writer editor for live preview, syntax highlighting, and export to PDF, DOCX, HTML, and more.
How do I go the other way, markdown to Word?
Use the Markdown to Word converter, which turns your markdown into a formatted .docx file you can open directly in Microsoft Word.

Got the markdown? Now edit it.

Open the converted markdown in Markdown Writer for a focused editor with live preview, syntax highlighting, and export back to Word, PDF, and more.

Open the editor

Related tools