Need AI Training/Help?CloudYeti.io/meet
MarkdownMe
Markdown to email guide

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.

Direct answer

Email clients do not render Markdown pipe tables — the pasted | and --- characters stay as plain text. To show a table in an email, use a real HTML <table> with inline styles: border-collapse on the table, padding and a border on each td, and a shaded background on header cells. Paste that as rich text into the compose window.

Open Markdown to Email converter

When to use this

  • A status table or comparison drafted in Markdown must go into an email body.
  • A pasted table renders as rows of pipes and dashes.
  • The table must survive Outlook desktop, which is the strictest common client.

Steps

  1. Keep the table small — email bodies are around 600px wide, so 2-4 columns is the practical limit.
  2. Rebuild the pipe table as an HTML <table> with one <tr> per row and inline styles on every cell.
  3. Style header cells with a background color and bold text; style body cells with padding and a border.
  4. Copy the HTML as rich text and paste it into the compose window.
  5. Send a test to an Outlook address if the audience includes corporate recipients.

Example conversion

Markdown input
| Phase | Owner | Status |
| --- | --- | --- |
| Schema freeze | Priya | Done |
| Dual-write | Marcus | In progress |
Email HTML output
<table style="border-collapse:collapse;width:100%;margin:12px 0;">
  <tr>
    <th style="border:1px solid #d1d5db;background:#f3f4f6;padding:8px 12px;text-align:left;">Phase</th>
    <th style="border:1px solid #d1d5db;background:#f3f4f6;padding:8px 12px;text-align:left;">Owner</th>
    <th style="border:1px solid #d1d5db;background:#f3f4f6;padding:8px 12px;text-align:left;">Status</th>
  </tr>
  <tr>
    <td style="border:1px solid #d1d5db;padding:8px 12px;">Schema freeze</td>
    <td style="border:1px solid #d1d5db;padding:8px 12px;">Priya</td>
    <td style="border:1px solid #d1d5db;padding:8px 12px;">Done</td>
  </tr>
  <tr>
    <td style="border:1px solid #d1d5db;padding:8px 12px;">Dual-write</td>
    <td style="border:1px solid #d1d5db;padding:8px 12px;">Marcus</td>
    <td style="border:1px solid #d1d5db;padding:8px 12px;">In progress</td>
  </tr>
</table>

Common mistakes

  • Do not paste the raw pipe table — no mainstream email client parses Markdown tables.
  • Do not style the table with CSS classes or a <style> block; Outlook desktop strips both, so every style must be inline on the cell.
  • Do not build wide tables — anything past 4 columns wraps badly on phones, where most email is read.

FAQ

Why does my Markdown table show as pipes and dashes in email?
Pipe tables are Markdown source syntax. Email clients render HTML, not Markdown, so the | and --- characters have no meaning and display literally. The table must be real <table> HTML before it renders.
What styles does an email table need to render in Outlook?
Inline styles only: border-collapse:collapse on the <table>, and border plus padding on each <th> and <td>. Outlook desktop uses Word's rendering engine and ignores stylesheet rules, so anything not inline disappears.
Is there a simpler alternative to a table in email?
Often yes. A short bold-label list ('Schema freeze — Priya — Done') reads fine on mobile and needs no table markup. Use a real table only when rows genuinely need column alignment.
Can I screenshot the table instead?
A screenshot renders consistently but is not copyable, not searchable, and invisible to recipients who block images. Use HTML for data people may need to quote or paste; use an image only for layout-critical visuals.

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.

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.

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.

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.