Guide
Markdown to HTML for email
Write in Markdown, send real HTML. Here is why email needs different output from a web page, and how to get it.
Why normal HTML breaks in email
Email clients are not browsers. Many strip or ignore <style> blocks, external stylesheets and most modern CSS. HTML that looks perfect on a web page can arrive in an inbox with default fonts, no spacing and broken tables.
The dependable approach is to put styles directly on each element with the style attribute. That is what the Email-safe output mode does.
What the converter changes
Choosing Email-safe (inline styles) in Options converts your Markdown as usual, then adds inline styles to every element:
<p style="margin:0 0 16px;font-size:16px;line-height:26px;color:#333333;">
Hello from Markdown.
</p>- Headings, paragraphs, links, lists, quotes, code, tables and rules get explicit sizes, margins and colors.
- Syntax-highlighting classes are turned off, because email clients drop class-based styling.
- Output is a fragment. Paste it into the body of your email or newsletter editor.
How to use it
- Open the converter with Email-safe output selected.
- Paste or type your Markdown.
- Check the preview, then choose Copy HTML.
- Paste it into your email tool’s HTML or source editor.
Before you send
- Use absolute image URLs (
https://…) and always write alt text. Relative paths do not resolve in an inbox. - Send yourself a test. Gmail, Outlook and Apple Mail each render slightly differently, especially Outlook on Windows.
- Keep it simple. Single-column content converts reliably. Complex multi-column layouts need a dedicated email template.
- Mind dark mode. Some clients invert colors automatically, so check contrast on both.
- Leave sanitization on unless you fully trust the source of your Markdown.
What it doesn’t do
The converter styles content, not layouts: there is no header, footer, button or column system. Use it for the text-heavy body of a message and combine it with your email platform’s template for the rest.