Google Docs Markdown Guide
Google Docs automatic markdown formatting — what works, what doesn't, and how to enable it.
Quick Reference
Google Docs markdown support at a glance — auto-converts on spacebar when enabled.
| Feature | Syntax | Notes | |
|---|---|---|---|
| Heading H1 | # text | Auto-converts on spacebar | |
| Heading H2 | ## text | Auto-converts on spacebar | |
| Heading H3 | ### text | Auto-converts on spacebar | |
| Bold | **text** | Auto-converts on spacebar | |
| Italic | *text* or _text_ | Auto-converts on spacebar | |
| Strikethrough | ~~text~~ | Limited support — may not convert | |
| Bullet list | - or * or + | Auto-converts on spacebar | |
| Numbered list | 1. | Auto-converts on spacebar | |
| Horizontal rule | --- | May convert in some contexts | |
| Blockquote | > text | Limited — may not render correctly |
Enabling Markdown
Markdown auto-detection is disabled by default. Here's how to turn it on.
How to Enable
Tools > Preferences > Automatically detect Markdown
- Click Tools in the menu bar
- Select Preferences
- Check "Automatically detect Markdown"
- Click OK
How Auto-Detection Works
Markdown converts when you press spacebar after the syntax
# →Heading 1## →Heading 2**bold** →bold- →• Bullet itemWhat 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
Heading 1
Heading 2
Heading 3
Bold and Italic
Double asterisks for bold, single for italic — converts automatically
bold text
italic text
also italic
bold and italic
Lists
Dash or asterisk for bullets, 1. for numbered lists
- Item one
- Item two
- Item three
- First
- Second
- Third
Horizontal Rule
Three dashes may convert to a horizontal rule in some contexts
Strikethrough (Limited)
~~text~~ may convert — behavior can vary by version
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
| 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
```javascript\nconsole.log('Hello')\n```
Workaround: Manually apply Courier New font for code-like appearance
Images — Not Supported
 markdown image syntax is ignored

Workaround: Use Insert → Image or drag and drop
Links — Not Supported
[text](url) link syntax is not converted by Google Docs
[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
- Write markdown in any editor
- Convert to HTML at allmarkdowntools.com
- Copy the rendered HTML
- In Google Docs: Edit → Paste special → Paste from HTML
Use Google Docs Add-ons
Third-party add-ons extend markdown support in Google Docs
- 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
Docs to Markdown add-on
File → Download → .html
then /html-to-markdown
Not Supported in Google Docs Markdown
Standard markdown features that Google Docs ignores — use these workarounds instead.
Markdown table syntax does not work — use Insert > Table instead
Triple backtick fenced code blocks are not supported — use monospace font manually
 does not embed images — use Insert > Image
Markdown link syntax is not converted — use Insert > Link or Ctrl+K
Pro Tips
Markdown auto-detection is off by default. Go to Tools > Preferences > check "Automatically detect Markdown" to enable it. Without this, typing # does nothing special.
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.
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.
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.