Google Docs added a "Markdown detection" feature in 2023 under Tools > Preferences > Automatically detect Markdown. It was a step in the right direction, but it's far from complete.
If you regularly paste AI output into Google Docs, understanding exactly what this feature does (and doesn't do) will save you a lot of frustration.
How to enable markdown detection
- Open Google Docs
- Go to Tools > Preferences
- Check Automatically detect Markdown
- Click OK
Once enabled, Google Docs will attempt to convert some markdown syntax when you type or paste it.
What Google Docs detects correctly
Bold and italic
Typing **bold** produces bold text. Typing *italic* produces italic text. This works reliably.
Strikethrough
~~strikethrough~~ is detected and converted. This is one of the more reliable detections.
Links
[text](url) syntax is sometimes detected and converted to a clickable link, but the behavior is inconsistent. It works more reliably when typing than when pasting.
What Google Docs misses
Headings
# Heading 1, ## Heading 2, etc. are NOT detected. This is the most significant gap. Headings are fundamental to document structure, and Google Docs simply ignores the # syntax.
Tables
Markdown tables (pipe-separated columns with dashes) are not detected at all. You get literal pipe characters and dashes.
Code blocks
Fenced code blocks (triple backticks) are not converted to any kind of code formatting. The backtick characters appear as plain text.
Inline code
Single backtick `code` is not detected. The backticks appear literally.
Ordered and unordered lists
While Google Docs has its own list support, it does not detect markdown list syntax (- for bullets, 1. for numbers) and convert it to native Google Docs lists consistently.
Blockquotes
> quote syntax is not detected.
Task lists
- [ ] and - [x] checkbox syntax is not detected.
The real-world impact
For simple text with bold and italic, Google Docs' markdown detection is adequate. But for anything that looks like a typical AI response (headings for structure, tables for comparisons, code blocks for examples), the detection falls far short.
A typical ChatGPT response uses:
- 2 to 3 heading levels for organization
- Bold and italic for emphasis
- Lists for step-by-step instructions
- Tables for comparisons
- Code blocks for technical content
Google Docs detects maybe 20% of this formatting. The rest shows up as raw markdown symbols.
Filling the gaps
Unmarkdown™ handles everything Google Docs' markdown detection misses:
| Element | Google Docs Detection | Unmarkdown™ |
|---|---|---|
| Bold/italic | Works | Works |
| Headings H1 to H3 | Not detected | Full support |
| Tables | Not detected | Full support with header formatting |
| Code blocks | Not detected | Monospace with background |
| Inline code | Not detected | Styled code spans |
| Ordered/unordered lists | Inconsistent | Full support with nesting |
| Blockquotes | Not detected | Styled with border |
| Task lists | Not detected | Checkbox formatting |
| Links | Sometimes | Always works |
How to use both together
The best workflow combines both tools:
- For quick edits where you're typing markdown directly in Google Docs, the built-in detection handles bold and italic fine
- For pasting AI output (ChatGPT, Claude, Gemini), use Unmarkdown™ to convert the full response before pasting
This gives you the best of both worlds: native Google Docs markdown typing for simple formatting, and proper conversion for complex AI output.
Will Google improve this?
Google has been slowly adding markdown features to Docs. The detection was added in 2023, and they may expand it over time. But even if Google adds full markdown support, the challenge of pasting from AI tools goes beyond detection. It involves handling the gray background issue, preserving table structure, and styling code blocks, all of which require awareness of the destination app's capabilities.
Other destinations
If you work across multiple apps, the formatting challenges are different for each:
- Word has no markdown detection but accepts rich text paste well
- Slack uses its own mrkdwn format, not standard markdown
- Email needs inline-styled HTML for cross-client compatibility
- OneNote supports all 6 heading levels (better than Google Docs)
Unmarkdown™ handles all of them from a single interface.
Related reading
- Why ChatGPT Output Looks Terrible When You Paste It (And How to Fix It)
- How to Paste ChatGPT Tables into Google Docs Without Breaking
- How to Export Obsidian Notes to Google Docs Without Losing Formatting
- The AI Formatting Problem Nobody Talks About
- How to Convert Markdown to Google Docs (3 Methods Compared)
- Google Docs Alternatives for Writers Who Use AI
