How to Convert Markdown to Word (DOCX) Without Losing Formatting

You wrote the spec in Markdown because that is how you think. Legal, a client, or a manager still wants a .docx they can comment on. The job is not “make it open in Word.” The job is to keep Heading 1/2/3 as real styles, lists as lists, and tables as tables, so Navigation pane, Track Changes, and a company template still work.

Shrynk’s desktop Convert tab does md → docx (and markdown → docx) locally. There are no extra options on that pair: the mapping is the product. It does not convert PDF to Word. If that is the search you meant, stop here.

What “survived” actually means

After a conversion, open the file in Word (or LibreOffice) and check the Home ribbon and the Navigation pane, not just the first screen.

In the .mdYou want in WordWhat usually fails
# / ## / ###Heading 1 / 2 / 3 stylesPasted preview: “Normal + bold”, TOC and outline break
- / 1.Bullet / numbered listsLines that only look like lists
GFM pipe table + |---|A Word table with a header rowASCII art tables aligned with spaces
[text](url), `code`Clickable link, monospaced runRaw markdown left in the paragraph
Local image ![alt](./img.png)Embedded picture in the docxBroken path if you moved the .md without the image
Mermaid, shortcodes, some footnotes—They do not become Visio/SmartArt. Export a PNG first or delete them

Shrynk’s Markdown to DOCX path embeds common raster images that sit next to the file (PNG, JPEG, GIF, WebP). If the image path is wrong, the run still finishes; that cell is just empty. Check the pictures before you send the file.

Why paste-from-preview keeps biting you

A GitHub or VS Code preview copied into Word looks fine until someone applies “Heading 1 = navy, 16pt” from a template. Then every “heading” is still Normal text with leftover bold. Comments attach to the wrong outline. A dedicated conversion maps markers to styles once. That is the difference between a dump and a document.

Opening the .md directly in a recent Word build is better than paste, but versions disagree on tables and images. If you have to send the same folder every Friday, do not depend on “Word felt like it that day.”

Do this in Shrynk (one file)

  1. Install Shrynk for Windows (free). First-run notes: Install and first run.
  2. Stay on Convert. Filter Document or search docx.
  3. Click the Markdown → DOCX card. The options panel stays empty on purpose; this pair has no quality slider.
  4. Drop one .md or .markdown file. If it references ./images/foo.png, keep that folder next to the file.
  5. Pick an output folder if you do not want the .docx beside the source.
  6. Start. Open the result and check Navigation pane + one table + one image.

Free allows one file per run. That is enough to test a README. A docs/ tree is a batch job (Pro, $9 one-time).

Shrynk Convert tab: md → docx selected. Search box shows md. No extra conversion options on this pair.
Convert tab, search md. The Markdown → DOCX card has no quality slider; the mapping is the product.

Prepare the Markdown so Word does not surprise you

A file you can check in two minutes

Put this in check.md next to a PNG named shot.png, convert it, then use Word’s Navigation pane:

# Title that must become Heading 1

## Section that must become Heading 2

A paragraph with **bold**, a [link](https://getshrynk.com/), and `inline code`.

- Bullet one
- Bullet two

| Col A | Col B |
| ----- | ----- |
| keep  | header |

![screenshot](./shot.png)

If Heading 1 does not appear in the pane, the conversion failed the only test that matters. If the table is a paragraph of pipes, the source was not a GFM table. If the picture is missing, the path was wrong, not “Word hates Markdown.”

Pandoc vs Word Open vs Shrynk

ToolUse whenSkip when
Paste from previewNever for a file someone else will templateAlways, if you have a converter
Word “Open” on .mdOne-off, recent Word, simple fileTables, images, a weekly folder
PandocCitations, custom templates, academic stackYou just need GFM to a normal docx on Windows
ShrynkLocal GFM, optional batch, same app as image/video convertYou need PDF in or DOCX back to Markdown

Shrynk is the ConvertET engine inside one installer. It is not trying to replace Pandoc’s reference-doc templates. If your firm has a .dotx with 14 heading styles, convert first, then apply the template in Word. Do not expect the converter to load that template.

Send-to-client checklist

When not to use this converter

Folder of specs

One mapping per run: all Markdown to DOCX, same output directory. Split drafts from published notes if you do not want both. Count files in vs files out. History in the app reopens the folder; details are in How conversion works.

FAQ

Does converting Markdown to Word keep headings and tables?

Yes for the usual GitHub-flavored set: headings as Word Heading styles, bold/italic, links, lists, blockquotes, fenced code, and pipe tables with a header row. Mermaid, shortcodes, and some footnote flavors do not become native Word objects.

Can Shrynk convert PDF to Word?

No. Markdown to Word and Markdown to HTML only. PDF is an output of some ebook routes, not an Office importer. See supported formats.

Is this the same as opening the .md in Microsoft Word?

No. Word’s Markdown support varies. A dedicated conversion exists so styles stay styles after a template is applied.

How do I convert many .md files at once?

Same card, many files or a folder, Pro license. Free is one file so you can verify the mapping first.

Need Word files from a folder of Markdown, on the PC? Download Shrynk for Windows. Free to install. $9 one-time for batch.