Unmarkdown
Email

Markdown in Gmail: Why It Doesn't Work and How to Fix It

Updated Feb 20, 2026 · 3 min read

Gmail has no markdown support. Unlike some developer tools and chat platforms, Gmail's compose window is a pure rich text editor. It understands bold, italic, lists, and links, but only when they arrive as HTML. Markdown symbols are treated as plain text.

What Gmail does with markdown

When you paste markdown into Gmail's compose window:

  • # Heading appears as the literal text "# Heading"
  • **bold** appears as the literal text "bold"
  • Tables show as pipe characters and dashes
  • Code blocks show as text surrounded by backticks
  • Links show as [text](url) instead of clickable text

Gmail makes no attempt to interpret any of this. There's no setting to enable, no extension to install that changes Gmail's core behavior.

The browser extension approach

Extensions like Markdown Here took a different approach: write in markdown inside Gmail, then click a button to convert it to rich text. This works for people who prefer to compose in markdown.

But that's the opposite workflow from what most people need today. With AI tools, you're not writing markdown; you're receiving it from ChatGPT, Claude, or Gemini and trying to get it into Gmail with proper formatting.

The copy-paste approach

The simplest solution: convert the markdown to email-compatible HTML before pasting.

  1. Copy the AI output (from ChatGPT, Claude, etc.)
  2. Paste into unmarkdown.com/for-email
  3. Click "Email"
  4. Paste into Gmail's compose window

The result is properly formatted text: real headings, bold and italic, tables with borders, code blocks with monospace font. Gmail accepts the rich text paste and renders everything correctly.

Why "Paste without formatting" doesn't help

Gmail offers Ctrl+Shift+V to paste without formatting. This strips all styling and gives you plain text. That removes the markdown symbols but also removes all structure: no headings, no bold, no lists. You just get a flat block of text.

What formatting works in Gmail after conversion

ElementSupported
Headings (H1 to H3)Yes, with distinct sizing
Headings (H4 to H6)Partial, may not be distinct
Bold and italicYes
StrikethroughYes
Tables with bordersYes
Code blocksYes (gray background, monospace)
BlockquotesYes (gray border, italic)
Lists (bullet and numbered)Yes, up to 3 levels
LinksYes, clickable
ImagesDepends on Gmail's image handling

Inline styles are the key

The reason generic markdown-to-HTML converters often fail in Gmail is that Gmail strips <style> blocks and external CSS. Only inline styles survive.

Unmarkdown™'s email output uses inline styles on every element:

<h2 style="font-size:20px;font-weight:bold;margin-top:1.5em">Heading</h2>
<p style="font-size:15px;line-height:1.6">Paragraph text</p>

This approach works across Gmail, Outlook, iCloud Mail, and other clients because inline styles are universally supported.

Outlook and iCloud Mail

The same converted output works in:

  • Outlook Desktop (Mac/Windows): Full support for headings, tables, code blocks
  • Outlook Web: Same as Gmail, full inline style support
  • iCloud Mail: Full support for all elements

You don't need to convert separately for each email client. One conversion works everywhere.

Tips for emailing AI content

  1. Keep it concise. AI tends to be verbose. Edit down before sending.
  2. Test large tables. Tables wider than 5 columns may not display well on mobile.
  3. Preview before sending. Gmail's compose window shows you exactly what recipients will see.
  4. Use headings for structure. Recipients scan emails. Clear headings help.

Your markdown deserves a beautiful home.

Start publishing for free. Upgrade when you need more.

View pricing