How To Enable Markdown In Google Docs | Turn On Docs’ Built-In Markdown

Google Docs has a built-in Markdown feature you enable in Tools > Preferences on a computer — once checked, you can type Markdown directly, paste and copy Markdown, and import or export .md files.

Markdown shortcuts in Google Docs used to require a third-party add-on or workaround. That changed in mid-2024 when Google rolled out native Markdown support to Docs, Slides, and Drawings on the web. The feature is off by default, but one checkbox in Preferences turns it on. Once enabled, you can type Markdown formatting inline, paste Markdown from other tools, copy content as Markdown, and even open or save .md files directly. This article walks through exactly how to enable it, what formatting works, and where the built-in tool still leaves you wanting more.

What the Built-In Markdown Feature Actually Does

Google’s native Markdown support means you can type Markdown syntax and see it convert to rich formatting automatically—like typing # Heading 1 and watching it become a heading. It also adds three export and import actions: Paste from Markdown, Copy as Markdown, and File > Download > Markdown (.md). These are all available on a computer in Google Docs, Google Slides, and Google Drawings.

This is not a full Markdown editor. Docs still stores content as rich text behind the scenes, and the Markdown is interpreted as you type or paste. For writers who want to work purely in Markdown and export clean .md files for static-site generators or Git-based workflows, the built-in feature handles the common formatting cases well but skips some edge cases like tables and code blocks in Markdown input.

How To Enable Markdown in Google Docs (Step by Step)

Enabling the feature takes about ten seconds. Open any document on a computer, go to Preferences, and check one box.

1. Open a document in Google Docs on a computer.
2. Click Tools in the top menu bar, then select Preferences.
3. In the Preferences window, check Enable Markdown.
4. Click OK to save.

you’ll see the Markdown checkbox filled, and typing **bold text** in your document will instantly convert it to bold formatting as soon as you type the closing asterisks.

That’s it. No add-on, no extension, no admin override needed—Google says there is no admin control for this feature, so anyone with a personal Google account or a Workspace account can turn it on.

Supported Markdown Formatting in Google Docs

Google Docs supports the most common inline and block Markdown syntax. The table below shows what works and the exact syntax to use. The key gotchas are a required space after the hash for headings and no space between link text and the URL parentheses.

A few notes from testing: the heading syntax requires exactly one space after the hash—no space and it won’t convert. For links, a space between the closing bracket and the opening parenthesis breaks the conversion, so [text] (url) fails while [text](url) works. If you paste Markdown that uses a space, Docs won’t convert it; you’ll need to remove the space manually.

How To Use Paste From Markdown, Copy As Markdown, Import, and Export

Once Markdown is enabled, you get four additional actions beyond typing inline. These are the power features for moving content between Google Docs and Markdown-native tools like Notion, Obsidian, or GitHub.

Paste from Markdown: copy Markdown text from another app (or a raw .md file), right-click inside a Google Docs document on a computer, and select Paste from Markdown. Docs converts the Markdown formatting into its rich-text equivalent. This works for headings, bold, italic, links, and strikethrough.

Copy as Markdown: select content in a Google Docs document on a computer, right-click, and choose Copy as Markdown. The copied content is now Markdown syntax, ready to paste into another app that accepts Markdown.

Import a .md file: in Google Docs, go to File > Open > Upload and select a Markdown file. Or upload the file to Google Drive, right-click it, and choose Open with > Google Docs. Docs converts the Markdown to rich text.

Export as .md: in Google Docs on a computer, go to File > Download > Markdown (.md). Docs saves a plain-text Markdown version of your document with all the formatting converted to Markdown syntax.

These actions are available to anyone with a personal Google account or a Workspace account—Google’s rollout began July 16, 2024 for Rapid Release domains and July 31, 2024 for Scheduled Release domains, so any account created or updated since then should have the feature.

Common Mistakes People Make

A few pitfalls trip up even experienced Markdown users when they first try Google Docs’ built-in support. Knowing these saves time.

• No space after #. Typing #Heading won’t work. It must be # Heading with a space. This is the single most common issue in Google’s official support thread.
• Space between link text and URL. [text] (url) fails. Remove the space so it reads [text](url).
• Expecting mobile support. The feature works only on a computer (the web app). The Google Docs mobile apps do not support Markdown typing or the Paste/Copy actions.
• Expecting full Markdown spec. Google’s implementation covers the basics but does not support tables, inline HTML, fenced code blocks, or task lists when typing or pasting Markdown. If your workflow depends on those, you’ll need an add-on (covered below).
• Thinking it changes how Docs stores files. Docs still saves documents as rich text in Google’s own format. Markdown is only an input and output option—your .docx and .gdoc files remain unchanged.

The Third-Party Add-On Option: Docs to Markdown

If the built-in Markdown support doesn’t cover your use case, the free and open-source Docs™ to Markdown (GD2md-html) add-on from the Google Workspace Marketplace is the established alternative. It converts any Google Doc to Markdown or HTML with more control over formatting—it handles tables, code blocks, headings up to depth 6, images, and list nesting better than Google’s native Markdown export.

The trade-off is that the add-on doesn’t help with importing Markdown into Docs or with typing Markdown inline. It’s primarily an export tool. For most users, the built-in feature is enough for copy-paste and export tasks. If you regularly convert Docs to Markdown for static-site generators, documentation, or GitHub, the add-on is worth installing.

Checklist for Getting the Most Out of Google Docs Markdown

• Enable the feature in Tools > Preferences > Enable Markdown.
• Type headings with a space after the hash (# Heading).
• Use Paste from Markdown to bring in content from other Markdown apps.
• Use Copy as Markdown to export formatted text as Markdown syntax.
• Export whole documents via File > Download > Markdown (.md).
• Import .md files via File > Open > Upload.
• Install the Docs to Markdown add-on if you need table and code-block support in exports.
• Work on a computer—Markdown features are not available on mobile.