What happens when you convert DOC to MD
- The DOC is opened by LibreOffice, the open-source office suite, on our conversion server and saved as DOCX, and pandoc, the open-source document converter, turns that into GitHub-flavoured Markdown.
- Headings become # lines, bulleted and numbered lists become - and 1. items, and tables, links, bold and italic keep their Markdown form. Only headings that use heading styles become # headings; text that was simply made big and bold stays a paragraph.
- Images are left out, and so is layout: fonts, colours, columns, headers, footers and page numbers have no place in Markdown.
- This conversion runs on our server: the file is uploaded, converted, and deleted together with the result as soon as the result has been sent back to you. Nothing is kept. Files up to 25 MB are accepted.
How to convert DOC to MD online
- Press "Choose DOC files" and select one or more files, or drag them onto the box. Files up to 25 MB each can be converted.
- There are no settings to choose: the converter keeps everything the target format can hold.
- Press "Convert to MD". The file is uploaded to our conversion server, converted in a few seconds, and deleted together with the result as soon as the result is sent back.
- Save each MD with its download button. Our server has already deleted both your DOC and the MD by then.
Why convert DOC to MD?
DOC files usually come from older Word files, templates and documents from legacy systems. People convert them to MD because Markdown is readable as it is and fits wikis, documentation sites and note apps such as Obsidian.
In short, DOC is good at what it was made for, and MD is the more practical choice when the file has to open, upload or print somewhere else. DOC opens in Word, Google Docs, Pages and LibreOffice Writer, while MD shows as plain text in browsers; editors such as Obsidian, Typora and VS Code render it.
How to convert DOC to MD on Windows, Mac, iPhone and Android
On Windows
Open this page in Chrome, Edge or Firefox, drag your DOC files in from File Explorer, and press Convert. Each MD is saved to your Downloads folder.
On a Mac
Safari, Chrome and Firefox all work. Drag the DOC files from Finder onto the drop zone and the MD files land in Downloads.
On iPhone and iPad
Open the page in Safari and tap Choose DOC files. You can pick from Photos or from the Files app. The converted MD appears in Files, in the Downloads folder.
On Android
Open the page in Chrome, tap Choose DOC files and pick them from Files or your gallery. The MD is saved to the Download folder, where any file manager can find it.
Best settings for DOC to MD
There are no settings: the output is GitHub-flavoured Markdown, which GitHub, GitLab, Obsidian, VS Code and most static site generators read.
For the cleanest result, use Word's built-in heading styles (Heading 1, Heading 2) in the DOC before converting, because those are what become Markdown headings.
DOC vs MD: the differences
| DOC | MD | |
|---|---|---|
| Full name | Word 97 to 2003 document | Markdown |
| Type | word-processing document | document |
| Created by | Microsoft | John Gruber |
| First released | 1997 | 2004 |
| Compression | Lossless | Lossless |
| What it holds | formatted text, images and tables in a binary file | plain text with simple symbols for headings, lists, links and emphasis |
| In a browser | opens in Word, Google Docs, Pages and LibreOffice Writer | shows as plain text in browsers; editors such as Obsidian, Typora and VS Code render it |
| Common uses | older Word files, templates and documents from legacy systems | documentation, README files, notes and blogging tools |
| MIME type | application/msword | text/markdown |
About DOC and MD files
What is a DOC file?
DOC is the binary Word format used before 2007. Unlike DOCX it is not a ZIP of XML files, so its contents cannot be read without a program that understands the binary layout.
What is an MD file?
Markdown marks formatting with plain characters: # for headings, * for lists and emphasis. It reads naturally as text and converts cleanly to HTML, which is why developers and note apps use it.
DOC to MD not working? Common problems
- "Files up to 25 MB can be converted." Server conversions have a size limit. Compress the images inside the file, or split it, and try again.
- "The conversion took too long and was stopped." Very long or complex files can pass the 90 second limit. Split the file and convert the parts.
- The file will not convert. It may be password protected, damaged, or saved in a newer or unusual version of the format.
Convert DOC to MD from the command line
LibreOffice and pandoc do the same on your own computer:
soffice --headless --convert-to docx input.doc
pandoc input.docx -t gfm -o output.mdConverting on your own computer keeps the file entirely local, which is worth it for very large or very sensitive documents. For everything else, the converter on this page does it without installing anything.
DOC to MD converter FAQ
Will I lose quality converting DOC to MD?
The words and their structure are kept exactly: headings, lists, tables and links. Images, fonts and page layout are not, because Markdown has no place for them.
Why is the MD a different size from the DOC?
Much smaller than the DOC: Markdown is plain text, without images, fonts or formatting data.
Are my DOC files uploaded?
Yes, for this conversion. A faithful DOC to MD conversion needs LibreOffice and pandoc, two open-source tools, which cannot run in a browser. The file travels over an encrypted connection, is converted in a private temporary folder, and is deleted together with the MD as soon as the result has been sent back to you. We do not keep, read or share it.
Can I convert several DOC files to MD at once?
Yes. Select or drop as many files as you like; they are converted one after another and each gets its own download button.
How do I open an MD file?
MD shows as plain text in browsers; editors such as Obsidian, Typora and VS Code render it. MD is common for documentation, README files, notes and blogging tools.
Is this DOC to MD converter free?
Yes. There is no sign-up and no watermark. Because this conversion uses our server, there is a fair-use limit of 25 MB per file and a number of files per hour, which stops the service being overloaded.
Can I convert DOC to MD on my phone?
Yes. It works in Safari on iPhone and iPad and in Chrome on Android. The conversion happens on our server, so it is as fast on a phone as on a computer; the MD is saved to your Downloads folder.