How to Batch Convert Markdown to Word on Mac (3 Methods)

When you need batch conversion

Single-file conversion is fine when you're working on one document. But many workflows involve dozens or hundreds of Markdown files that all need to become Word documents at the same time.

• Exporting an Obsidian vault — your entire vault is .md files, and a client or collaborator needs them in Word
• Shipping documentation — your dev team writes docs in Markdown, but stakeholders need .docx files
• AI content pipelines — you've generated multiple reports or drafts in Markdown and need to deliver them as Word documents
• Academic submissions — converting a semester of notes or paper drafts from Markdown to the required Word format

Converting files one at a time through an online tool or manual Pandoc commands doesn't scale. Here are three methods that handle batch conversion properly.

Method 1: Pandoc for loop

If you already have Pandoc installed, a simple shell loop converts every .md file in a directory. This is the most common approach for developers who are comfortable with the terminal.

Basic batch conversion

Open Terminal, navigate to the folder with your .md files, and run:

for f in *.md; do pandoc "$f" -o "${f%.md}.docx"; done

This converts every .md file in the current directory to a .docx file with the same name. The ${f%.md}.docx syntax strips the .md extension and replaces it with .docx.

Recursive batch conversion

If your Markdown files are nested in subdirectories (like an Obsidian vault), use find instead:

find . -name "*.md" -exec sh -c 'pandoc "$1" -o "${1%.md}.docx"' _ {} \;

This finds every .md file in the current directory and all subdirectories, converting each one in place.

Tradeoffs

• Requires Pandoc installed — you need Homebrew and brew install pandoc first
• Terminal knowledge required — not accessible for non-technical users
• No progress indicator — for large batches, you're staring at a blinking cursor
• Error handling is manual — if one file fails, you need to track it down yourself

Method 2: Reusable bash script

If you batch convert regularly, wrap the Pandoc loop in a script you can run anytime. This adds error handling, progress output, and makes the process repeatable.

#!/bin/bash
# md2docx-batch.sh — Convert all .md files in a directory to .docx

DIR="${1:-.}"
COUNT=0
ERRORS=0

for f in "$DIR"/*.md; do
  [ -f "$f" ] || continue
  OUTPUT="${f%.md}.docx"
  if pandoc "$f" -o "$OUTPUT" 2>/dev/null; then
    echo "Converted: $(basename "$f")"
    ((COUNT++))
  else
    echo "FAILED: $(basename "$f")"
    ((ERRORS++))
  fi
done

echo ""
echo "Done. $COUNT converted, $ERRORS failed."

Save this as md2docx-batch.sh, make it executable with chmod +x md2docx-batch.sh, and run it with ./md2docx-batch.sh /path/to/folder.

Tradeoffs

• Still requires Pandoc — the script is a wrapper, not a replacement
• One-time setup — you need to create and save the script
• More visible progress — you see each file as it converts
• Reusable — run the same command whenever you need a batch conversion

Method 3: MarkDrop (drag and drop)

MarkDrop lets you select multiple .md files in Finder and convert them all at once — no terminal required. Select your files, right-click, and choose "Convert with MarkDrop." Every file gets converted to .docx and saved alongside the originals.

How to batch convert with MarkDrop

1. Select multiple .md files in Finder (Cmd+click or Shift+click)
2. Right-click and choose "Convert with MarkDrop" from the Services menu
3. Done — each .md file gets a matching .docx file in the same folder

You can also drag a batch of files directly onto the MarkDrop app icon in your Dock or Applications folder.

Tradeoffs

• macOS only — no Windows or Linux version
• Free tier: 5 conversions/month — Pro ($9.99 one-time) for unlimited
• No terminal required — works entirely from Finder
• Preserves formatting — headings, tables, code blocks, and lists convert correctly

Which method should you use?

If you're already in Terminal, the Pandoc loop is the quickest path. If you batch convert regularly from the command line, the bash script saves time. If you want the simplest workflow, MarkDrop lets you do everything from Finder.