Overview

gramdown converts the .docx file you get from Grammarly’s export into clean, GitHub-Flavored Markdown.

It is built for that one file. Grammarly’s export has a handful of quirks (code set in a plain monospace font with no language, links that arrive underlined, indentation made of invisible characters), and gramdown is designed around them rather than trying to be a general-purpose .docx converter. How it works has the detail.

Ways to run it

Command line

curl -fsSL https://gramdown.tobythe.dev/install.sh | sh
gramdown draft.docx -o draft.md

Verifies the download's checksum and installs to ~/.local/bin. See Downloads for pinning a version and other options.

Not seeing your platform, or want every option? See Downloads.

In the browser

Nothing to install: drop a .docx anywhere on this site and it converts on your device. Nothing is uploaded. See Browser converter.

From your own code

npm install @gramdown/core

@gramdown/core is the conversion engine behind all of the above. See the convert() API.

Your first conversion

# print the Markdown to your terminal
gramdown draft.docx

# write it to a file instead
gramdown draft.docx -o draft.md

# also guess a language for each code block (always double-check these)
gramdown draft.docx -o draft.md --guess-lang