Skip to content

Instantly share code, notes, and snippets.

@plembo
Last active November 15, 2024 18:14
Show Gist options
  • Save plembo/409a8d7b1bae66622dbcd26337bbb185 to your computer and use it in GitHub Desktop.
Save plembo/409a8d7b1bae66622dbcd26337bbb185 to your computer and use it in GitHub Desktop.
Convert docx to markdown with pandoc

Convert Word documents to markdown with pandoc

I use pandoc to convert masses of Word documents to markdown. Still working on a generic script, but for now here's the "gist" of what I type into the terminal:

$ myfilename="example"
$ pandoc \
-t markdown_strict \
--extract-media='./attachments/$myfilename' \
$myfilename.docx \
-o $myfilename.md

Pandoc markdown is nice, but with Word documents it often adds odd things in translation. Stick to markdown_strict to avoid that.

I try to organize media (images, etc) embedded in documents under an attachments subdirectory with folders named for each file. This helps avoid "collision" between media file names and makes conversion out of markdown into other formats (HTML, PDF) less messy.

@iambumblehead
Copy link

works perfectly

@mrtngrsbch
Copy link

cool, nice gist !

@STrRedWolf
Copy link

This helps get me 90% of the way there. I use a mix of 'markdown+bracketed_spans+backtick_code_blocks+fenced_code_attributes+fenced_divs' but I have to manually re-add the []{custom-style="foobar"} code as well as the horizontal lines... well, close...

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment