How can doc/docx files be converted to markdown or structured text?

Ms Office Problem Overview

Is there a program or workflow to convert .doc or .docx files to Markdown or similar text?

PS: Ideally, I would welcome the option that a specific font (e.g. consolas) in the MS Word document will be rendered to text-code: ```....``` .

Ms Office Solutions

Solution 1 - Ms Office

Pandoc supports conversion from docx to markdown directly:

pandoc -f docx -t markdown foo.docx -o foo.markdown

Several markdown formats are supported:

-t gfm (GitHub-Flavored Markdown)  
-t markdown_mmd (MultiMarkdown)  
-t markdown (pandoc’s extended Markdown)  
-t markdown_strict (original unextended Markdown)  
-t markdown_phpextra (PHP Markdown Extra)  
-t commonmark (CommonMark Markdown)

Solution 2 - Ms Office

docx -> markdown

Specifically regarding the question (docx --> markdown), use the Writeage plugin for Microsoft Word. It also works the other way round markdown --> docx.

More Options

Use a Conversion Tool for multi-file conversion.
Use a WYSIWYG Editor for single files and superior fonts.

Which Conversion Tools?

I've tested these three: (1) Pandoc (2) Mammoth (3) w2m

Pandoc

By far the superior tool for conversions with support for a multitude of file types (see Pandoc's man page for supported file types):

pandoc -f docx -t gfm somedoc.docx -o somedoc.md

NB

To get pandoc to export markdown tables ('pipe_tables' in pandoc) use multimarkdown or gfm output formats.
If formatting to PDF, pandoc uses LaTeX templates for this so you may need to install the LaTeX package for your OS if that command does not work out of the box. Instructions at LaTeX Installation

Which WYSIWYG Editors?

For docx, use Writeage.

Maintaining Superior Fonts

If you wish to preserve unicode characters, emojis and maintain superior fonts, you'll get some milage from the editors below when using copy-and-paste operations between file formats. Note, these do not read or write natively to docx.

Programatic Equivalent

For a programatic equivalent, you might get some results by calling a different pdf-engine and their respective options but I haven't tested this. The pandoc defaults to 'pdflatex'.

pandoc --pdf-engine=
pandoc --pdf-engine-opt=STRING

Update: A4 vs US Letter

For outside the US, set the geometry variable:

pandoc -s -V geometry:a4paper -o outfile.pdf infile.md

Footnote

Its worth mentioning here - what's not obvious when discovering Markdown is that MultiMarkdown is by far the most feature rich markdown format.

MultiMarkdown supports amongst other things - metadata, table of contents, footnotes, maths, tables and YAML.

But Github's default format uses gfm which also supports tables. I use gfm for Github/GitLab and MultiMarkdown for everything else.

Solution 3 - Ms Office

Given that you asked this question on stackoverflow you're probably wanting a programmatic or command line solution for which I've included another answer.

However, an alternative solution might be to use the Writage Markdown plugin for Microsoft Word.

Writage turns Word into your Markdown WYSIWYG editor, so you will be able to open a Markdown file and edit it like you normally edit any document in Microsoft Word. Also it will be possible to save your Word document as a Markdown file without any other converters.

Under the covers, Writage uses Pandoc that you'll also need to install for this plugin to work.

It currently supports the following Markdown elements:

Headings
Lists (numbered and bulleted)
Links
Font styles such as bold, italic
Tables
Footnotes

This might be the ideal solution for many end users as they won't need to install or run any command line tools - but rather just stick with what they are most familiar.

Solution 4 - Ms Office

Mammoth is best known as a Word to HTML converter but it now supports a Markdown writer module. When I last checked, Mammoth Markdown support was still in its early stages, so you may find some features are unsupported. As usual ... check the website for the latest details.

Install

To use the Javascript version ... install NodeJS and then install Mammoth:

npm install -g mammoth

Command line

Command line to convert a Word document to Markdown ...

mammoth document.docx --output-format=markdown

API

NodeJS API to convert to Markdown ...

var mammoth = require("mammoth");
mammoth.convertToMarkdown({path: "path/to/document.docx"});

Features:

Mammoth Markdown writer currently supports:

Lists (numbered and bulleted)
Links
Font styles such as bold, italic
Images

The Mammoth command line tools and API have been ported to several languages:

With NO Markdown (May 2016):

With Markdown:

Solution 5 - Ms Office

You can use Word to Markdown (Ruby Gem) to convert it in one step. Conversion can be as simple as:

$ gem install word-to-markdown
$ w2m path/to/document.docx

It routes the document through LibreOffice, but also does it best to semantice headings based on their relative font size.

There's also a hosted version which would be as simple as drag-and-drop to convert.

Solution 6 - Ms Office

Word to Markdown might be worth a shot, or the procedure described here using Calibre and Pandoc via HTMLZ, here's a bash script they use:

#!/bin/bash
mkdir temp
cp $1 temp
cd temp
ebook-convert $1 output.htmlz
unzip output.htmlz
cd ..
pandoc -f html -t markdown -o output.md temp/index.html
rm -R temp

Solution 7 - Ms Office

From here:

unoconv -f html test.docx
pandoc -f html -t markdown -o test.md test.html

Solution 8 - Ms Office

You can convert Word documents from within MS Word to Markdown using this Visual Basic Script:

https://gist.github.com/hawkrives/2305254

Follow the instructions under "To use the code" to create a new Macro in Word.

Note: This converts the currently open Word document ato Markdown, which removes all the Word formatting (headings, lists, etc.). First save the Word document you plan to converts, and then save the document again as a new document before running the macro. This way you can always go back to the original Word document to make changes.

There are more examples of Word to markdown VB scripts here:

https://www.mediawiki.org/wiki/Microsoft_Word_Macros

Solution 9 - Ms Office

Here's an open-source web application built in Ruby to do this exact thing: https://word2md.com

Solution 10 - Ms Office

If you're using Linux, try Pandoc (first convert .doc/.docx into html with LibreOffice or something and then run it).

On Windows (or if Pandoc doesn't work), you can try this website (online demo, you can download it): Markdownify

Solution 11 - Ms Office

For bulleted lists you can paste a list into Sublime Text and use multiselect ( tested ) or find and replace ( not tested ) to replace eg the proprietary MS Word characters with -, -- etc

This doesn't work with headings but it may be possible to use a similar technique with other elements.

Solution 12 - Ms Office

For .doc Word files:

antiword -f some_file.doc

antiword's homepage: http://www.winfield.demon.nl/

Content Type	Original Author	Original Content on Stackoverflow
Question	Lorenz Lo Sauer	View Question on Stackoverflow
Solution 1 - Ms Office	massives	View Answer on Stackoverflow
Solution 2 - Ms Office	Tony Barganski	View Answer on Stackoverflow
Solution 3 - Ms Office	Tony O'Hagan	View Answer on Stackoverflow
Solution 4 - Ms Office	Tony O'Hagan	View Answer on Stackoverflow
Solution 5 - Ms Office	Benjamin J. Balter	View Answer on Stackoverflow
Solution 6 - Ms Office	Tobias Kienzler	View Answer on Stackoverflow
Solution 7 - Ms Office	Federico	View Answer on Stackoverflow
Solution 8 - Ms Office	Dan Murphy	View Answer on Stackoverflow
Solution 9 - Ms Office	Brigadeiro	View Answer on Stackoverflow
Solution 10 - Ms Office	Spotlight	View Answer on Stackoverflow
Solution 11 - Ms Office	byronyasgur	View Answer on Stackoverflow
Solution 12 - Ms Office	HappyFace	View Answer on Stackoverflow