The dev.emailmd/emailmd MCP server renders Markdown into email-safe HTML, lints draft content for deliverability problems, and provides email previews. It is focused on converting author-written Markdown into HTML suitable for email clients while checking common deliverability issues.

🛠️ Key Features

Render Markdown into email-safe HTML
Lint drafts for deliverability problems
Preview emails

🚀 Use Cases

Convert Markdown-based content into email-ready HTML
Check email drafts for likely deliverability issues
Validate formatting and output via email previews

⚡ Developer Benefits

Email-oriented Markdown-to-HTML output
Early detection of deliverability issues via linting
Faster review through previewable email output

{ "type": "object", "properties": { "markdown": { "type": "string", "maxLength": 262144, "description": "The emailmd markdown document, optionally starting with YAML frontmatter." }, "minify": { "description": "Minify the HTML. Recommended for sending; helps stay under Gmail's 102KB clip limit.", "type": "boolean" }, "partials": { "description": "Named markdown partials spliced in wherever the document says \"::: include <name>\".", "type": "object", "propertyNames": { "type": "string", "maxLength": 200 }, "additionalProperties": { "type": "string", "maxLength": 262144 } } }, "required": [ "markdown" ], "$schema": "http://json-schema.org/draft-07/schema#" }

{ "type": "object", "properties": { "markdown": { "type": "string", "maxLength": 262144, "description": "The emailmd markdown document, optionally starting with YAML frontmatter." }, "partials": { "description": "Named markdown partials spliced in wherever the document says \"::: include <name>\".", "type": "object", "propertyNames": { "type": "string", "maxLength": 200 }, "additionalProperties": { "type": "string", "maxLength": 262144 } } }, "required": [ "markdown" ], "$schema": "http://json-schema.org/draft-07/schema#" }

{ "type": "object", "properties": { "page": { "description": "Docs page path, e.g. 'buttons' or 'directives/hero'. Omit for the index.", "type": "string", "maxLength": 200, "pattern": "^[a-z0-9][a-z0-9/-]*$" } }, "$schema": "http://json-schema.org/draft-07/schema#" }

Quick Start

typescript

import { 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

v0.3.0 migration: render() is now async. Update calls from render(md) to await render(md). Requires Node 20+ (MJML 5).

MCP

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:

bash

# Hosted (Streamable HTTP)
https://www.emailmd.dev/api/mcp

# Or run it locally over stdio
npx emailmd mcp

Published to the official MCP registry as dev.emailmd/emailmd. See the MCP docs for per-client setup.

Contributing

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.

emailmd

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

render

lint

read_docs

emailmd

Write markdown. Ship emails. No HTMHELL.

Install

Quick Start

CLI

React

Learn More

MCP

AI

Contributing

Acknowledgements

License

Install

markdown	string	required	The emailmd markdown document, optionally starting with YAML frontmatter.
minify	boolean	optional	Minify the HTML. Recommended for sending; helps stay under Gmail's 102KB clip limit.
partials	object	optional	Named markdown partials spliced in wherever the document says "::: include <name>".