How to convert markdown to Word
Markdown to word conversion needs more than pasting text into a document. The symbols in markdown, such as # and **, have to become real Word formatting, or you end up retyping every heading by hand. This converter reads your markdown, builds the matching Word structure and writes a .docx file in your browser.
The built-in example is a short project update. Converted, the tool reports: 3 headings, 3 paragraphs, 8 list items, 1 table, 1 code block, 1 quote, 2 links and 1 divider. The file is about 5 KB and is named project-update.docx, after the first heading.
The preview shows the text on a white page in the font and size you picked, so you can spot a broken table or a list that did not nest before you download.
What each markdown part becomes in Word
- Headings from
#to######become the built-in Heading 1 to Heading 6 styles. That means the Navigation pane and an automatic table of contents work. - Paragraphs become normal paragraphs. Bold, italic and strikethrough become character formatting.
- Bulleted lists use real Word bullets that change shape at each level. Numbered lists use real numbering, keep the number they start at, and restart separately for every list.
- Task items such as
- [x] donebecome a line that starts with a checked or empty box character. These are text characters, not clickable form checkboxes. - Tables become real Word tables. The header row is bold and shaded, repeats at the top of each page, and column alignment from the
:---:row is kept. - Block quotes use the Quote style, which has a grey bar on the left.
- Inline code and code blocks use the Consolas font on a light grey background. There is no syntax coloring.
- A
---line becomes a horizontal line. - Links to web addresses, email addresses and phone numbers become clickable hyperlinks.
Convert markdown to docx: fonts, size and page
You set the font once and every style follows it. Body text uses the size you choose. Headings are larger, from 1.8 times the body size for Heading 1 down to the body size for Heading 6. Margins are 1 inch (2.54 cm) on all sides.
A4 is the usual choice outside North America. US Letter is the default for most documents in the United States and Canada. The file does not embed fonts, so if the reader does not have your font, Word substitutes a similar one.
Markdown to Word for AI answers and README files
Chat tools and developer sites write markdown. Pasting it straight into Word keeps the symbols, so you see literal asterisks and hash signs. Paste the answer here instead and download a clean document. If you only need the words without any formatting marks, Markdown to Text strips them. You can also select text in the page preview, copy it and paste it into an email or Google Docs, though a .docx keeps the styles more reliably.
A README or a docs page often starts with a block of settings between two --- lines, called front matter. The converter drops that block and starts from the first real line.
Tables are a common source of markdown. If your data starts as a spreadsheet, CSV to Markdown builds the table, and HTML Table to Markdown does the same for a table on a web page. Then convert it to Word here.
Going back from Word to markdown
If you have a Word file and need markdown, use Word to Markdown. The Swap button between the two panels sends your new .docx straight to it, so you can check a round trip. Headings, lists, tables, links and code come back as they went in.
What it does not convert
- Pictures are not embedded. A web image becomes the text
Image: alt textlinked to the picture. A local or embedded image becomes the same text without a link. The line above the preview tells you how many. - Raw HTML in markdown is not interpreted. Tags stay in the text as typed.
- Math, diagrams such as Mermaid, footnotes and definition lists are left as written.
- The output is a .docx file. The old .doc format is not supported.
- Links that are not web, email or phone links, such as a link to another .md file, become plain text.
Privacy
Your text is read and the .docx is built inside your browser tab. Nothing is uploaded or stored. See the Privacy Policy for details.