DEV Community

Alex Spinov
Alex Spinov

Posted on

Email.md Converts Markdown to Responsive Email HTML — And It Actually Works

#webdev #productivity #opensource #discuss

The Problem Every Developer Hates

You need to send a nicely formatted email. You open your email template. It's 400 lines of nested <table> tags with inline styles. You make one change, and Outlook renders it as a dumpster fire.

I've been there. Every developer has been there.

Enter Email.md

Email.md just hit the front page of Hacker News, and for good reason. It converts plain Markdown into responsive, email-safe HTML that actually renders correctly across:

  • Gmail
  • Outlook (including the notoriously broken desktop client)
  • Apple Mail
  • Yahoo Mail
  • Thunderbird

How It Works

You write this:

# Welcome to Our Service

Hey **John**,

Thanks for signing up! Here's what you can do:

- Browse our [API docs](https://example.com/docs)
- Check out the [tutorials](https://example.com/tutorials)
- Join the [community](https://example.com/community)

> Pro tip: Start with the quickstart guide.

Cheers,
The Team
Enter fullscreen mode Exit fullscreen mode

And Email.md outputs email-safe HTML with:

  • Inline styles (no <style> blocks — they break in some clients)
  • Table-based layout (yes, it's 2026 and we still need tables for email)
  • Responsive design that works on mobile
  • Dark mode support

Why Developers Should Care

If you're building:

  • SaaS products — your transactional emails (welcome, password reset, invoices) can be written in Markdown
  • Newsletters — write content in Markdown, convert to email HTML
  • Notification systems — template emails without touching HTML tables
  • API services — generate email content programmatically from Markdown

Comparison: Before and After

Before (traditional email HTML):

<table width="600" cellpadding="0" cellspacing="0" border="0">
  <tr>
    <td style="padding: 20px; font-family: Arial, sans-serif; font-size: 16px; line-height: 24px; color: #333333;">
      <h1 style="margin: 0 0 20px 0; font-size: 24px; color: #111111;">Welcome</h1>
      <!-- 200 more lines of this -->
    </td>
  </tr>
</table>
Enter fullscreen mode Exit fullscreen mode

After (Email.md):

# Welcome

Hey there, thanks for joining!
Enter fullscreen mode Exit fullscreen mode

That's it. Same result, 95% less code.

For the Automation Crowd

This pairs perfectly with data pipelines. If you're scraping data and need to send reports via email, you can:

  1. Collect data with your scraping tools
  2. Format results as Markdown
  3. Convert to email HTML with Email.md
  4. Send via SMTP

Clean pipeline, no HTML template maintenance.

The Takeaway

Email HTML is a solved problem — we just kept solving it the hard way. Email.md is the kind of tool that makes you wonder why it didn't exist sooner.

Do you still hand-code email HTML, or have you found a better way? I'm curious what tools others use. Share in the comments!

Follow me for daily deep dives into developer tools and APIs.

Top comments (0)