Guide

How to export a Google Doc to Markdown

The short answer: Google Docs cannot export Markdown. File → Download offers .docx, .odt, .rtf, .pdf, .txt, .html and EPUB — there is no .md option and no setting that adds one. Markdown comes from a second step, and there are three sensible ones.

Option 1: an add-on (fastest for one document)

Google's add-on store has converters that read the open document and hand back Markdown. The best-known is Docs to Markdown; install it from Extensions → Add-ons → Get add-ons, then run it from the Extensions menu.

  • Works on the document as it stands, no download first.
  • Usually keeps headings, lists, links, bold and italic.
  • Needs an add-on with access to your document, which is a permission decision worth making deliberately.
  • Output quality varies with tables, comments and nested lists.

Option 2: download and convert locally (best for scripts and batches)

Download the doc as Word (.docx) or as a web page (.html), then convert on your own machine. With Pandoc, one command does it:

pandoc draft.docx -t gfm -o draft.md

  • Nothing is granted access to your Google account beyond the download.
  • Repeatable — script it over a folder of documents.
  • Needs a terminal and a Pandoc install.
  • .docx keeps more structure than .html in practice, particularly lists and tables.

Option 3: draft where Markdown is the export format

If the document is still being written, the conversion is the wrong end of the problem. Quorly is a browser editor that imports .docx and exports .md, so the route is: download the Google Doc as Word, open it in the editor, keep writing, then Export → Markdown.

  1. In Google Docs: File → Download → Microsoft Word (.docx).
  2. In Quorly: Import → choose the file. Headings, lists, bold, italic and links are rebuilt on import.
  3. Write or edit, then Export → Markdown. In Chromium browsers the file picker writes the .md straight to disk; elsewhere it downloads.

That is only worth doing if you will keep writing. Converting a finished document is a job for option 1 or 2. Before you submit it, the word counter gives you the number most forms ask for, without uploading the draft to check it.

What Markdown loses on the way out

Markdown is a text format, so anything that is not text does not survive:

  • Comments and suggestions — gone. Resolve them first if they matter.
  • Tracked changes — gone; the document's current state is what converts.
  • Floating and wrapped images — usually flattened to a link or dropped. Inline images work if the converter keeps them and you keep the files together.
  • Precise layout — columns, page breaks, headers and footers are not part of Markdown.
  • Footnotes — supported by some converters, not by all. Check before relying on them.

Headings, bold, italic, links, lists, block quotes and code blocks are the parts that convert reliably, which is exactly the parts a draft needs.

Which option should you use?

If you…Use
have one finished doc and want it over in a minuteOption 1, an add-on
have a folder of docs, or want no add-on permissionsOption 2, Pandoc locally
are still writing and will keep editingOption 3, draft in an editor that exports Markdown

Questions

Frequently asked questions

Does Google Docs support Markdown export?

No. Google Docs downloads as .docx, .odt, .rtf, .pdf, .txt, .html and EPUB, but not .md. Markdown has to come from an add-on or from a second tool.

What gets lost when a Google Doc becomes Markdown?

Comments, tracked changes, floating images and precise layout. Headings, bold, italic, lists, links, quotes and code survive in a good conversion; tables and footnotes depend on the converter, so check them.

Can I open a Word file in Quorly instead?

Yes. Quorly imports .docx in Chromium-based browsers, so you can download the Google Doc as Word, open it in the editor, and export Markdown from there.

Ready when you are

Start writing — free

Open the editor and try it on your own draft.

← Back to Quorly