How to Paste Markdown Into Gmail
Gmail's compose window does not render Markdown. Convert the Markdown to inline-styled HTML, copy as rich text, and paste — headings, bold, lists, and links arrive formatted.
Direct answer
Gmail does not render Markdown in the compose window — pasted **bold** and - bullets stay as literal characters. Convert the Markdown to inline-styled HTML, copy it as rich text, then paste into Gmail. The compose window accepts rich-text pastes, so headings, bold, lists, and links render immediately.
Open Markdown to Email converterWhen to use this
- A Markdown draft, README excerpt, or AI answer must go out as a Gmail message.
- Pasted text shows asterisks and pound signs instead of bold and headings.
- You want clickable links and real bullet lists without formatting each line by hand in the toolbar.
Steps
- Paste the Markdown draft into the converter.
- Preview the output to confirm headings, bullets, and links converted.
- Press Copy Rich to copy the formatted version.
- Click into the Gmail compose body and paste normally.
- Send a test message to yourself if the email goes to a client or a large list.
Example conversion
# Launch update Hi all, The new pricing page is **live**. - [Pricing page](https://example.com/pricing) - Docs updated - Old links redirect Questions? Reply here.
<h1 style="margin:24px 0 12px;font-size:24px;color:#111;">Launch update</h1> <p style="margin:12px 0;line-height:1.6;color:#374151;">Hi all,</p> <p style="margin:12px 0;line-height:1.6;color:#374151;">The new pricing page is <strong>live</strong>.</p> <ul style="margin:12px 0;padding-left:20px;"><li style="margin:4px 0;"><a href="https://example.com/pricing" style="color:#2563eb;text-decoration:underline;">Pricing page</a></li> <li style="margin:4px 0;">Docs updated</li> <li style="margin:4px 0;">Old links redirect</li></ul> <p style="margin:12px 0;line-height:1.6;color:#374151;">Questions? Reply here.</p>
Common mistakes
- Do not paste with Ctrl+Shift+V — that is paste-without-formatting and strips the rich text back to plain.
- Do not compose in Gmail's Plain text mode; the paste loses all formatting there.
- Do not leave raw URLs as Markdown [text](url) syntax — convert first so links are clickable.
FAQ
- Does Gmail support Markdown?
- No. Gmail's compose window is a rich-text editor with no Markdown parsing. Some browser extensions add it, but out of the box, pasted Markdown stays as literal characters. Converting to HTML first works without any extension.
- Why did my paste lose all formatting in Gmail?
- Two common causes: you pasted with Ctrl+Shift+V (paste without formatting), or the compose window is in Plain text mode. Use a normal paste and switch off Plain text mode in the compose menu.
- Can I paste the raw HTML source into Gmail instead?
- Not directly — pasting HTML source into the compose body shows the tags as text. Gmail needs the HTML on the clipboard as rich text, which is what the Copy Rich button provides.
- Do Markdown headings become real headings in Gmail?
- Yes. # and ## convert to h1 and h2 elements with inline font sizes, and Gmail keeps them on paste. Recipients see larger, bolder heading text, not pound signs.
Related email guides
How to Paste Markdown Into Outlook
Outlook does not render Markdown, so pasted ## and ** stay visible. Convert Markdown to inline-styled HTML first, copy as rich text, then paste into the Outlook compose window.
ChatGPT Response to a Professional Email
ChatGPT answers arrive as Markdown, and pasting them into Gmail or Outlook leaves ** and ## visible. Clean the draft, convert it to inline-styled HTML, and paste as rich text.
How to Put a Markdown Table in an Email
Pipe tables pasted into Gmail or Outlook collapse into a wall of pipes and dashes. Email needs a real HTML <table> with inline styles — here is the markup that renders everywhere.
Markdown to Newsletter HTML
Write the newsletter in Markdown, convert it to inline-styled HTML, and paste the HTML source into your sending tool. Covers width, inline styles, and what breaks in Outlook.
Why Markdown Doesn't Render in Email
Email clients render HTML, not Markdown. The ** and ## you paste are source syntax that nothing in Gmail or Outlook interprets. Here is what is actually happening and the fix.
Convert Markdown to Outlook-Compatible HTML
Outlook desktop renders email with Word's engine and strips <style> blocks, so Markdown must become HTML with every style inlined. What survives Outlook, what does not, and the conversion.
AI Draft to Client-Ready Email
Turn a Claude or ChatGPT email draft into something a client should actually receive: strip the AI framing, verify the facts, cut the padding, convert the Markdown, and paste as rich text.
Fix Bullet Lists Breaking in Outlook
Pasted bullets show as hyphens, lose indentation, or merge into one paragraph in Outlook. The cause is Markdown or plain-text bullets arriving without list markup — here is the fix.