dev.emailmdPublished by emailmd.devOfficial publisherv0.13.2Updated Oct 25, 2026
Render markdown into email-safe HTML, lint drafts for deliverability problems, and preview emails.
emailmd turns markdown into email-safe HTML, lints drafts for deliverability issues, and gives a shareable preview, all from an AI assistant.
Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.
Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.
Read https://sourceweft.com/mcp/dev.emailmd%2Femailmd/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.Add this to your client's mcpServers config.
{
"mcpServers": {
"emailmd": {
"type": "http",
"url": "https://www.emailmd.dev/api/mcp"
}
}
}emailmd converts markdown into responsive, email-safe HTML that works across Gmail, Outlook, Apple Mail, Yahoo, and every other client.
v0.3.0 migration:
render()is now async. Update calls fromrender(md)toawait render(md). Requires Node 20+ (MJML 5).
Bar charts, progress meters, sparklines, KPI tiles, step trackers, and star ratings, each written as a plain markdown list:
[KPI tiles, a bar chart and a sparkline, rendered by emailmd from plain markdown lists]
They are drawn from table cells and text glyphs rather than images or SVG, so they still render when the client blocks remote images, and they redraw themselves in the plain-text part instead of collapsing to a list of numbers. See the directives reference.
emailmd also ships with a command-line interface.
Run emailmd --help for all options.
@emailmd/react provides a live-preview hook (useEmailmd), an <EmailPreview /> iframe component, and <EmailmdBuilder /> — the full builder as a drop-in component for your own app.
emailmd ships a Model Context Protocol server, so an AI assistant can render, lint, and preview emails for you. It exposes three tools — render (markdown to email-safe HTML), lint (flag deliverability problems without rendering), and read_docs (look up emailmd syntax) — over either transport:
Published to the official MCP registry as dev.emailmd/emailmd. See the MCP docs for per-client setup.
Prefer plain context over tools? emailmd is just markdown, so AI is great at writing templates. Feed the full docs to your AI tool:
Contributions are welcome! Feel free to open an issue or submit a pull request.
emailmd is under active development. The API may change between minor versions until we hit 1.0 — breaking changes are always called out in the changelog. See Stability & Versioning for what the semver contract covers.
MIT
Source: README.md at commit db9d638
Render an email
Render emailmd markdown into email-safe HTML. Returns html (the complete email document), text (the plain-text MIME part), meta (frontmatter), warnings (non-fatal repairs made while rendering; aim for none), htmlBytes, and previewUrl (a live browser preview of this exact document to share with the user).
minifymarkdownrequiredpartialsLint an email
Check emailmd markdown for deliverability, accessibility, and readability problems without rendering it: missing alt text, http:// links, Gmail's 102KB clip limit, generic link text, spam-trigger phrases, and more. Fix warnings before sending; suggestions are sometimes intentional (e.g. transactional emails without an unsubscribe link).
markdownrequiredpartialsRead emailmd docs
Fetch emailmd documentation from emailmd.dev. Call with no arguments for the index of all pages; pass page to read one (e.g. 'buttons', 'frontmatter', 'theme', 'directives/hero'). Read the relevant page before using syntax you are not sure about.
page100% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
npm install emailmdimport { render } from "emailmd";
const { html, text } = await render(`# Welcome!
Thanks for signing up.
[Get Started](https://example.com){button}`);
// html → complete email-safe HTML// text → plain text version for text/plain MIME part::: chart- Spotify: 16,900- Apple Podcasts: 12,400- Web player: 6,200- RSS: 2,900:::# Render to HTMLemailmd input.md
# Write to fileemailmd input.md -o output.html
# Plain text outputemailmd input.md --text
# Pipe from another commandecho "# Hello" | emailmdnpm install @emailmd/react emailmd# Hosted (Streamable HTTP)https://www.emailmd.dev/api/mcp
# Or run it locally over stdionpx emailmd mcphttps://www.emailmd.dev/llms-full.txt