Word to Markdown: DOCX to clean .md

Drop your Word document here

One or several: headings, lists, tables, links and pictures become clean Markdown

Reads .docx — writes .md, with pictures in a ZIP — nothing is uploaded

—
— —
✓ Applied

How useful was the Word to Markdown?

5.0 out of 5 · 1 rating

Write a review on Trustpilot

About this tool

Turn a Word document into Markdown you can actually use

Move a Word document into a README, a docs site, a wiki, Notion, Obsidian or a blog without retyping it. Drop the .docx and get clean Markdown back in a second, with the structure kept and the clutter left behind.

Copying from Word into a Markdown editor loses the headings and lists, and pasting HTML brings a mess of styles with it. This converter reads what each paragraph means instead: Word’s Heading 1 becomes #, a numbered list becomes 1., a table becomes a Markdown table, and links, bold and italic come with them. Fonts, colours and page layout are left out on purpose, because Markdown keeps structure, not appearance. Your document is read inside this browser tab and never leaves your device.

  • Free, no sign-up
  • Nothing uploaded
  • No watermark

Structure, not clutter

Headings, lists, tables and links come across; Word’s fonts, spacing and hidden styles don’t. The result reads cleanly on GitHub, in docs tools and in any Markdown editor.

Pictures handled your way

Get a ZIP with the .md and an images folder, one self-contained .md with the pictures built in, or just the text.

Private documents stay private

Contracts, reports and drafts are converted inside this tab. There is no server to upload to, no account and no copy kept anywhere.

Step by step

How to convert Word to Markdown

  1. Add your document

    Drop a .docx file on this page or press Browse files.

  2. Check the Markdown

    Read or edit the result, and switch to Preview to see it rendered.

  3. Copy or download

    Copy the Markdown, or download the .md (a ZIP when it has pictures).

Get the most out of it

Tips for the best results

  • Use Word’s heading stylesText styled with Heading 1, 2 and 3 becomes #, ## and ###. Text that is only made big and bold stays a normal paragraph, so apply real headings in Word first for the best result.
  • Old .doc filesOnly the newer .docx format can be read. Open a .doc in Word and use Save As → Word Document (.docx) first.
  • Merged table cellsMarkdown tables have no merged cells or nested tables, so those are flattened. Check complex tables in the Preview.
  • Google DocsUse File → Download → Microsoft Word (.docx), then drop that file here.

Questions

Common questions

Everything here runs in your browser, so the answer to “where does my file go?” is always: nowhere. More in the general FAQ.

How do I convert a Word document to Markdown?

Drop the .docx file on this page. It is converted straight away; check or edit the Markdown, then copy it or download the .md file. If the document has pictures you can save them in a ZIP beside the .md.

Is this Word to Markdown converter free, and is my file uploaded?

It is free, with no sign-up or limit, and nothing is uploaded: the document is read and converted inside your browser on your own device.

What does it keep from the Word document?

Headings, paragraphs, bold and italic, strikethrough, numbered and bulleted lists (including nested ones), tables, links and pictures. Fonts, colours, page layout, headers and footers are left out, because Markdown has no way to describe them.

What happens to the pictures?

You choose: Separate files saves a ZIP with the .md and an images folder it links to; Inside the file builds each picture into the .md as data, so it is one file; Leave out keeps only the text.

Does it convert tables?

Yes. Each Word table becomes a GitHub-flavoured Markdown table, with its first row as the header. Merged cells and tables inside tables are flattened, since Markdown tables can’t hold them.

Can it convert .doc files or Google Docs?

It reads .docx. Save an old .doc as .docx in Word first. For Google Docs, choose File → Download → Microsoft Word (.docx) and drop that file here.

Which Markdown flavour does it write?

GitHub-flavoured Markdown: # headings, - bullets, 1. numbered lists, pipe tables, ~~strikethrough~~ and fenced code. It works on GitHub and GitLab and in Obsidian, Notion, VS Code and most static site generators.

Can I convert Markdown back to Word?

Yes, with the Markdown to Word converter, which builds a .docx with Word’s own heading styles and lists.