How-to

Word to Markdown, and back again: a simple method

Updated ยท 6 min read

The short answer

To turn a Word file into Markdown, open the .docx in Wrdio, press Edit, then choose File, Export, Markdown on a computer. To go the other way, open the Markdown file in the editor and export it as a DOCX. Headings, bold text and lists come across as real formatting.

Markdown is plain text with a few symbols for structure: a # for a heading, ** around bold words, a dash for a bullet. People like it because it is light, readable anywhere and friendly to tools such as note apps and code repositories. Word documents, on the other hand, are what everyone else sends you.

So sooner or later you need to move text from one world to the other. Here is a simple way to do it in your browser, in both directions, without uploading the document anywhere.

Word to Markdown

  1. On the Wrdio home page, drop in your .docx and press Edit.
  2. On a computer, open File, then Export, and pick Markdown (*.md).
  3. Your browser downloads the file. Open it in any text editor to check it.

The export is only available on a computer. On a phone, the File menu offers DOCX and PDF.

What usually carries over

Plain structure translates well, but always open the result and look.

What needs a check

Markdown to Word

  1. Open the editor from the home page (press New document, then Edit if the editor is not already open).
  2. Drag your .md file onto the editor page.
  3. Look at the result. A # Title line arrives as a real heading, **bold** as bold text, and a dashed list as a bulleted list.
  4. Tidy anything you like, then use File, Export, Word document (*.docx).

Because the headings become real heading styles, the document works with navigation panes and tables of contents straight away. That is the main advantage over pasting plain text.

A quick example. This Markdown:

# Meeting notes

Agreed **three** things:

- Ship on Friday
- Update the docs
- Book the review

opens as a heading, a sentence with one bold word, and a three-item bulleted list.

Tips for a clean conversion

When a command line is a better choice

If you convert dozens of files, or you want to script it, a free tool called Pandoc does the same job from the terminal: pandoc report.docx -o report.md goes one way, and swapping the names goes the other. For one or two files, a browser is quicker.

Want the PDF instead? See how to save a Word document as a PDF without breaking it, or read about the editor in our online DOCX editor guide.

Questions people ask

How do I convert a Word document to Markdown for free?

Open the .docx in Wrdio, press Edit and use File, Export, Markdown on a computer. It is free and the file stays on your device.

How do I convert Markdown to Word?

Open the .md file in the Wrdio editor. Headings, bold text and lists become real formatting. Then use File, Export, Word document (.docx) to save it.

Will tables and images survive the conversion?

Simple tables often do, and complicated ones may not. Images may not come across at all. Always check these in the result.

Is there a command-line option?

Yes. Pandoc is a free command-line converter that turns .docx into Markdown and back. It suits batches of files and people who are comfortable in a terminal.

Keep reading

All guides