Stop Pasting Markdown — Outlook Doesn’t Render It (Here’s What Works)

The first thing most people do when they try to paste a GitHub README or Notion doc into Outlook is hit Ctrl+V and hope the asterisks and backticks magically become bold text and lists. They don’t. And worse—they often assume Outlook just ‘doesn’t support Markdown’ full stop. That’s half-true. The real issue isn’t lack of support—it’s that Outlook *never interprets raw Markdown*. It ignores it completely. So your `**bold**` shows up as literal asterisks. The beauty of this approach is: you don’t need Markdown at all. You need the right paste behavior—and Outlook has it built in.

Quick Answer

Outlook desktop (365, 2019, 2016) and Outlook on the web do not render Markdown syntax. There’s no setting under File > Options > Mail > Compose messages or anywhere else that enables Markdown parsing. What you *can* do is paste richly formatted content from apps like Word, VS Code (with preview), or Obsidian—and retain structure using Paste Options. The exact path: after pasting, press Ctrl+V, then immediately press Ctrl+Alt+V to open Paste Special, or click the small clipboard icon that appears at the bottom-right corner of the pasted block.

Step-by-Step Walkthrough

1. Write or copy Markdown elsewhere. Use VS Code with the 'Markdown Preview' extension, Typora, or Obsidian. Format your list, headings, and code blocks there—then use Ctrl+Shift+P → "Markdown: Copy as HTML" (in VS Code) or right-click the preview pane and choose "Copy HTML".
2. In Outlook, start a new email (Ctrl+N) and place your cursor where you want content.
3. Paste normally (Ctrl+V). You’ll see plain text with raw symbols—don’t panic.
4. Click the tiny clipboard icon that appears at the bottom-right of the pasted text (or press Ctrl+Alt+V). Choose Paste as HTML (Outlook 365/2019) or Keep Source Formatting (Outlook 2016).
5. Verify formatting. Headings become <h2>-styled text, bullet lists convert cleanly, inline `code` becomes monospace if the source HTML includes <code> tags.

Common Pitfalls

• Pasting from GitHub directly: GitHub’s rendered HTML includes heavy CSS classes and !important rules Outlook strips. You lose colors and spacing. Always copy from a local Markdown preview—not the browser page.
• Using Outlook Web App (OWA) and expecting Paste Special: OWA doesn’t show the clipboard icon or support Ctrl+Alt+V. Instead, paste into Word Online first, then copy again and paste into Outlook Web. Yes—it’s two extra steps. No, Microsoft hasn’t fixed it since 2021.
• Assuming *** or --- creates horizontal rules: Outlook ignores them. Even if you paste HTML with <hr>, some Exchange servers strip it for security. Test with your own mailbox first.
• Using nested lists with mixed dashes and asterisks: VS Code’s HTML export flattens nesting if indentation is inconsistent. Use only spaces (not tabs) and align bullets at 2–4 space intervals for reliable conversion.

Pro Tips

What most people don’t realize is that Outlook’s Rich Text Editor has keyboard shortcuts that mimic Markdown *input*, even if it doesn’t parse it. Try this:

• Type * (asterisk + space) at the start of a line, then type your text and press Enter. Outlook auto-converts it to a bulleted list—no copy-paste needed.
• Type 1. or 1) , then text and Enter: you get an auto-numbered list. Works for up to 10 levels deep (though readability drops after level 3).
• For code blocks: paste pre-formatted HTML with <pre><code class="language-powershell">Get-Mailbox -Identity</code></pre>. Then select the block and apply the Consolas font manually via Alt+H, F, C.

The counterintuitive part? You get cleaner results typing simple Markdown-like triggers *inside* Outlook than pasting full Markdown files. Why? Because Outlook’s auto-format engine is tuned for these patterns—not generic syntax.

Troubleshooting

If your HTML paste shows raw tags (<p>Hello</p>) or breaks layout, it’s likely one of these causes. Here’s how to fix it—and prevent recurrence:

Symptom	Cause	Fix	Prevention
All formatting vanishes; only plain text remains	Email is set to Plain Text mode (Alt+H, A, T)	Press Alt+H, A, R to switch to Rich Text	Go to File > Options > Mail > Compose messages and uncheck "Use Microsoft Outlook Rich Text format for composing messages"
Bullet points appear but no indentation	Outlook 2016 defaults to legacy list engine	Right-click list → "Adjust List Indents" → increase "Text indent" to 0.25"	In Outlook 2016, go to File > Options > Mail > Editor Options > Advanced and check "Show picture placeholders" (yes, it affects lists)
Code blocks render in Times New Roman	HTML lacks explicit font-family or Outlook overrides it	Select text → Alt+H, F, C → Consolas or Cascadia Code	Add inline style style="font-family:Consolas,sans-serif;" to <code> tags before pasting
Pasted HTML shows “&nbsp;” instead of spaces	Source app exports non-breaking spaces for alignment	Find/replace &nbsp; with regular space in Outlook’s Find dialog (Ctrl+H)	In VS Code, disable "Insert Spaces for Tabs" and use soft wraps instead of hard indents
Email arrives with broken images or missing fonts on recipient side	Exchange Online Protection (EOP) strips external CSS and some embedded styles	Avoid <style> blocks. Use inline styles only. Test with internal recipients first.	Send test emails to yourself and open in Outlook 2019/365 *and* Outlook Web to verify rendering
Paste Options icon doesn’t appear after Ctrl+V	Group Policy disables Paste Options (common in enterprise deployments)	Use Word as intermediary: paste HTML into Word, copy again, then paste into Outlook	Contact IT to enable registry key HKEY_CURRENT_USER\Software\Microsoft\Office\16.0\Outlook\Options\General\EnablePasteOptions = 1

One last note: Outlook for Mac (v16.87+) handles HTML paste more reliably than Windows versions—but still no Markdown interpretation. If you send to someone using Outlook Mobile, expect further simplification: lists become indented paragraphs, and <pre> blocks often collapse to single-line text. Always test with real recipients—not just your own inbox.