Skip to content
ToolPlankDEV
Text Tools
100% In-Browser Execution

Updated:

Word to Markdown Converter

Drop a .docx file and get markdown back. This word to markdown converter keeps headings, bold, italic, links, lists, tables and code, then tells you what Markdown cannot hold, such as images and comments. The file never leaves your device.

Processing in browser...

Loading the tool. It runs entirely in your browser, so your data is never uploaded.

More free tools you may need next.

Quick Guide

How to use Word to Markdown

Simple step-by-step instructions to get the exact output you need.

  1. 01

    Choose a .docx file

    Drop a Word document on the left panel or press Select .docx. Files up to 15 MB work. Example loads a small sample document made in your browser so you can see the output first.

  2. 02

    Set the markdown style

    Pick the list marker (dash, star or plus), the italic style, and whether pictures leave a placeholder behind. The result updates when you change an option.

  3. 03

    Read what was simplified

    Above the markdown, a note lists what Markdown cannot hold in your file, such as pictures, comments and text boxes, with a count for each.

  4. 04

    Copy or download

    Press Copy to put the markdown on your clipboard, or Download .md to save it. The file name follows your Word file.

How to convert Word to markdown

To convert word to markdown, the tool opens your .docx file in the browser, reads the document text and its styles, and writes markdown for the parts that markdown can express. A .docx file is a zip archive with the text in an XML file, and this converter reads that XML directly. Nothing is uploaded.

A document made from the built-in example, a project update with three headings, lists, a table, a code block and two links, comes out like this:

markdown
# Project update

This week the **beta launch** went well. Read the [full report](https://example.com/report) for numbers, or see the notes below.

## What shipped

- Faster search
- New export options
  - Word and PDF
  - CSV with custom delimiters
- [x] Bug fixes for `login` and `logout`

What is kept when you convert a Word document to markdown

  • Headings. Paragraphs in the Heading 1 to Heading 6 styles, and the Title style, become lines that start with one to six # signs. A paragraph with an outline level set is treated as a heading too.
  • Bold, italic and strikethrough, including bold and italic that comes from the Strong and Emphasis character styles.
  • Links. Word hyperlinks, link fields and plain web links keep their address.
  • Lists. Bulleted and numbered lists keep their nesting and the number a list starts at. Lines that begin with a ☐ or ☑ box become task items.
  • Tables. The first row becomes the header and column alignment is kept. Line breaks inside a cell are written as <br>, and a | inside text is escaped.
  • Code. A run of paragraphs in a monospace font, such as Consolas or Courier New, or in a style named Code or Source Code, becomes a fenced code block. A monospace phrase inside a sentence becomes inline code.
  • Block quotes from the Quote style.

Convert docx to markdown: what gets simplified

Markdown is plain text with a few marks, so a Word document always holds more than the result can. The note above the output counts each kind of loss, so you know where to look:

  • Pictures are not extracted. Each one leaves a placeholder like ![alt text](image-1.png), using the picture's alt text, so you can add the files yourself. Turn Image placeholders off to leave them out.
  • Footnotes, endnotes and comments are not converted.
  • Tracked changes: inserted text is kept as normal text and deleted text is removed.
  • Text boxes and shapes lose their text. Equations become plain text.
  • Merged table cells are split into separate cells, and a table nested inside a table is flattened to text.
  • Underline, font names, sizes, colors, highlights, alignment and page layout are not part of markdown and are dropped.
  • Headers and footers are ignored.

Word to markdown for Google Docs, Notion and GitHub

Most editors can export or import .docx, which makes it the common way to move writing into markdown. In Google Docs, choose File, Download, Microsoft Word (.docx) and drop the file here. The markdown then works in a GitHub README, a static site, a wiki or a note app.

If you only want the words with no symbols, run the markdown through Markdown to Text. If the document holds a data table, CSV to Markdown and HTML Table to Markdown cover other sources for the same kind of table.

Back to Word

To turn markdown back into a document, use Markdown to Word. The Swap button between the panels sends your markdown straight there. Headings, lists, tables, links and code survive the round trip, while fonts and colors from the original file do not come back.

File types and limits

  • Only .docx is supported. For an old .doc file, open it in Word or LibreOffice and use Save As .docx first.
  • Pages, Google Docs links, ODT and PDF files are different formats and are not read.
  • Password protected files cannot be opened.
  • Files up to 15 MB are accepted. A very long document can take a moment.

The file is opened and converted in your browser. It is not uploaded or stored. See the Privacy Policy for details.

Frequently Asked Questions

Technical Q&A for Word to Markdown

Common questions about edge cases, character encoding, and privacy guarantees.

Drop your .docx file on the left panel. The markdown appears on the right with a note of anything that could not be kept. Press Copy or Download .md.

Yes. The file is opened and converted in your browser, so it never leaves your device.

Yes. Heading styles become # lines, bulleted and numbered lists keep their nesting, and tables become markdown tables with the first row as the header.

Pictures are not extracted. Each one becomes a markdown image line with the picture's alt text and a file name such as image-1.png, so you can see where it was and add the file yourself. You can turn the placeholders off.

No. Only .docx is supported. Open the .doc file in Word or LibreOffice, save it as .docx, then convert that.

In Google Docs choose File, Download, Microsoft Word (.docx), then drop that file here. The result is markdown you can paste into a README or a note app.

Headings are found from the Word heading styles. A line that was only made big and bold has no heading style, so it stays a paragraph. Apply a heading style in Word and convert again.

Pictures, footnotes, comments, text boxes, headers, footers and visual formatting such as colors and fonts. A note above the output counts each one found in your file.

Inserted text is kept and deleted text is removed, as if the changes were accepted. The tool does not show the changes themselves.

Yes. Choose a dash, star or plus for bullets, and *italic* or _italic_ for emphasis. The output changes at once.