Build your AI Agent and let it work for your business 24/7 →

Word to Markdown Converter

Convert a Word .docx document to Markdown with headings, lists, links, tables and footnotes kept. Everything happens in your browser, so your file stays on your device.

  • 100% free
  • No sign-up
  • Runs in your browser

Drop a Word .docx file here

or

Converted in your browser. Your document never leaves your device.

Options

Headings

One level down turns H1 into H2, useful when pasting into a page that already has a title.

Markdown

0 words · 0 characters · 0 lines

From Word styles to Markdown

A .docx file is a zip folder of XML files that describe paragraphs, styles and formatting. This converter reads the meaning of each paragraph from its Word style rather than from how it looks. Heading 1 becomes#, Heading 2 becomes##, list paragraphs become Markdown lists and tables become pipe tables.

Getting the cleanest result

  • Use Word's built-in heading styles instead of bold, enlarged text.
  • Use real bullet and numbering lists instead of typed dashes or numbers.
  • Keep tables simple. Merged cells and nested tables are flattened into plain rows.
  • Check the warnings list for custom styles the converter didn't recognise.

Where Markdown from Word is useful

Markdown works in GitHub, Notion, Obsidian, most documentation tools and static site generators. It's also a compact way to give a long document to an AI assistant without losing its headings and lists.

How it works

How to use it

  1. Step 1

    Add your Word file

    Drop a .docx file onto the page or choose one from your device. It is converted in your browser.

  2. Step 2

    Choose what to keep

    Decide whether to embed images in the Markdown and how headings should be handled.

  3. Step 3

    Copy or download

    Review the Markdown or the preview, make any edits, then copy it or download it as a .md file.

FAQs

Frequently asked questions

Answers to common questions about the Word to Markdown Converter.

No. The .docx file is unpacked and converted inside your browser using the open-source Mammoth library. Nothing is sent to a server.

Not directly. The old .doc format (Word 97-2003) is a closed binary format that can't be read reliably in a browser. Open the file in Word, Google Docs or LibreOffice and save it as .docx, then convert that file here.

Headings (Heading 1 to 6, Title and Subtitle styles), paragraphs, bold, italic, strikethrough, links, bullet and numbered lists, tables, footnotes and, if you choose, images. Fonts, colours, text size and page layout are dropped because Markdown has no way to describe them.

Headings come from Word's built-in heading styles. If a heading was made by simply enlarging and bolding normal text, Word doesn't know it's a heading, so it comes out as a bold paragraph. Apply the Heading 1, Heading 2 styles in Word and convert again.

By default images are left out and counted, which keeps the Markdown short. Turn on Embed images to include them as base64 data URIs. That makes the Markdown self-contained but much larger, and some Markdown apps don't display data URIs.

Mammoth lists anything it couldn't map exactly, such as a custom paragraph style it doesn't recognise. The text is still converted, usually as a normal paragraph, so the warnings are a guide to what to double-check.

More free tools

Try another tool

Answer Instagram DMs without the copy and paste

Hypello sends instant replies to comments and DMs, and its AI agents collect customer details, share discount codes and pass chats to your team. Free for up to 1,000 DMs a month.