Let’s get this out of the way first: Google Docs doesn’t natively support Markdown. However, by using the free and open source Docs to Markdown add-on for Google Docs, you can quickly and easily export a Google Doc to Markdown. (The add-on doesn’t help with importing Markdown into Google Docs.)

This add-on was created by a retired Google technical writer, and it’s currently the best way to export a Google Doc to Markdown. Docs to Markdown is useful for teams that want to use Google Docs for the collaboration features, but ultimately need Markdown-formatted plain text to publish to a website.

Once you install the Docs to Markdown add-on in your Google account, you can open a document in Google Docs and access the add-on from the Add-ons menu. After you select the convert option, the Markdown-formatted version of your document will appear in a sidebar, as shown below. At that point, you can copy and paste the Markdown-formatted text into another application.

Markdown in Google Docs

I recently used Docs to Markdown to convert a 50-page Google Doc to Markdown. I can’t say that my experience was great, but it was better than manually converting the document to Markdown by hand.

One issue is that the add-on has strong opinions when it comes to syntax, and there’s no way to customize how the add-on outputs text to Markdown. For example, the add-on outputs italicized text using underscores instead of asterisks, something that could lead to unexpected errors in the output. I also discovered that the add-on doesn’t correctly handle link conversion. There were numerous stray spaces in my links, leading to broken formatting in the Markdown-formatted text.

No matter what type of document you convert, you should plan on inspecting the output that the Docs to Markdown add-on generates. The add-on still feels like a work-in-progress, and you may find yourself needing to fix broken formatting.

See Also

Take your Markdown skills to the next level.

Learn Markdown in 60 pages. Designed for both novices and experts, The Markdown Guide book is a comprehensive reference that has everything you need to get started and master Markdown syntax.

Get the Book
Want to learn more Markdown?

Don't stop now! 🚀 Star the GitHub repository and then enter your email address below to receive new Markdown tutorials via email. No spam!