https://blog.markdowntools.com/posts/how-to-convert-word-documents-to-markdown

Method 1: Using Pandoc (Recommended)

Pandoc is the most powerful and reliable tool for document conversion. It handles complex formatting and produces clean Markdown output.

Linux (Ubuntu/Debian):

sudo apt-get install pandoc


Basic Word to Markdown Conversion

Once installed, convert your Word document with this simple command:

pandoc -s document.docx -t markdown -o document.md

Advanced Pandoc Options

For better control over the conversion, use these additional flags:

pandoc -s document.docx -t markdown --extract-media=./media --wrap=none -o document.md

Options explained:

    -s: Creates a standalone document with proper metadata
    --extract-media=./media: Extracts images to a media folder
    --wrap=none: Prevents automatic line wrapping
    -t markdown: Specifies Markdown as the target format

Handling Images and Media

Pandoc automatically handles images embedded in Word documents:

pandoc document.docx -t markdown --extract-media=images/ -o output.md

This extracts all images to an images/ directory and updates the Markdown with proper image syntax.