Skip to content
AllMarkdownTools
Free · No signup · Instant

Google Docs Markdown Guide

Google Docs automatic markdown formatting — what works, what doesn't, and how to enable it.

See Quick Reference
Auto-formattingEnable in settingsLimited supportFree forever

Quick Reference

Google Docs markdown support at a glance — auto-converts on spacebar when enabled.

FeatureSyntax
Heading H1# text
Heading H2## text
Heading H3### text
Bold**text**
Italic*text* or _text_
Strikethrough~~text~~
Bullet list- or * or +
Numbered list1.
Horizontal rule---
Blockquote> text

Enabling Markdown

Markdown auto-detection is disabled by default. Here's how to turn it on.

How to Enable

Tools > Preferences > Automatically detect Markdown

README.md
Enable Markdown in Google Docs
  1. Click Tools in the menu bar
  2. Select Preferences
  3. Check "Automatically detect Markdown"
  4. Click OK
✅ Available in Google Workspace and personal accounts (added 2023)

How Auto-Detection Works

Markdown converts when you press spacebar after the syntax

README.md
# →Heading 1
## →Heading 2
**bold** →bold
- →• Bullet item

What Works

These markdown elements auto-convert in Google Docs when markdown detection is enabled and you press spacebar.

Headings

# (H1), ## (H2), ### (H3) auto-convert on spacebar

README.md

Heading 1

Heading 2

Heading 3

Bold and Italic

Double asterisks for bold, single for italic — converts automatically

README.md

bold text

italic text

also italic

bold and italic

Lists

Dash or asterisk for bullets, 1. for numbered lists

README.md
  • Item one
  • Item two
  • Item three
  1. First
  2. Second
  3. Third

Horizontal Rule

Three dashes may convert to a horizontal rule in some contexts

README.md

Strikethrough (Limited)

~~text~~ may convert — behavior can vary by version

README.md
strikethrough text

What Doesn't Work

These standard markdown elements are not supported in Google Docs and require workarounds.

Tables — Not Supported

Markdown table syntax renders as plain text — use Insert > Table instead

README.md
❌ Not supported

| Name | Age |\n| ---- | --- |\n| Alice | 30 |

Workaround: Use Insert → Table from the menu

Code Blocks — Not Supported

Triple backtick fenced code blocks do not render

README.md
❌ Not supported

```javascript\nconsole.log('Hello')\n```

Workaround: Manually apply Courier New font for code-like appearance

Images — Not Supported

![alt](url) markdown image syntax is ignored

README.md
❌ Not supported

![My diagram](https://example.com/image.png)

Workaround: Use Insert → Image or drag and drop

Links — Not Supported

[text](url) link syntax is not converted by Google Docs

README.md
❌ Not supported

[Visit Google](https://google.com)

Workaround: Select text and press Ctrl+K (Cmd+K on Mac) to insert a link

Workarounds

Practical strategies for working with markdown and Google Docs together.

Convert Markdown to HTML First

Use a markdown converter, then paste HTML into Google Docs

README.md
✅ Recommended workflow
  1. Write markdown in any editor
  2. Convert to HTML at allmarkdowntools.com
  3. Copy the rendered HTML
  4. In Google Docs: Edit → Paste special → Paste from HTML

Use Google Docs Add-ons

Third-party add-ons extend markdown support in Google Docs

README.md
Google Docs Add-ons for Markdown
  • Docs to Markdown — exports Google Docs to .md files
  • Markdown Here — renders markdown in place
  • DocuWriter — imports markdown files into Docs

Access via Extensions → Add-ons → Get add-ons

Export Google Docs to Markdown

Use the 'Docs to Markdown' add-on to export your Google Doc as a .md file

README.md
Exporting from Google Docs
Option 1
Docs to Markdown add-on
Option 2
File → Download → .html
then /html-to-markdown

Not Supported in Google Docs Markdown

Standard markdown features that Google Docs ignores — use these workarounds instead.

Tables

Markdown table syntax does not work — use Insert > Table instead

Code blocks

Triple backtick fenced code blocks are not supported — use monospace font manually

Images via markdown syntax

![alt](url) does not embed images — use Insert > Image

Links via [text](url)

Markdown link syntax is not converted — use Insert > Link or Ctrl+K

Pro Tips

1Enable markdown detection first

Markdown auto-detection is off by default. Go to Tools > Preferences > check "Automatically detect Markdown" to enable it. Without this, typing # does nothing special.

2Auto-detection triggers on spacebar

Unlike full markdown editors, Google Docs converts markdown syntax when you press spacebar after it. Type ## followed by a space to create an H2 heading.

3For full markdown, use a dedicated editor

Google Docs markdown support is minimal by design. For documents that rely heavily on markdown, write in a dedicated markdown editor and then paste the rendered HTML into Google Docs.

Frequently asked questions

Everything you need to know.

1

Does Google Docs support markdown?

Google Docs has limited markdown support added in 2023. When you enable "Automatically detect Markdown" in Tools > Preferences, it auto-converts some markdown syntax (headings #, bold **, lists -) when you press spacebar. It does not support tables, code blocks, images, or links via markdown syntax.

Convert HTML to markdown instead?

If you're exporting from Google Docs, the HTML export converts cleanly to markdown with our tool.

Try HTML to Markdown