Skip to content
Back to search

emailmd

Render markdown into email-safe HTML

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/anypost/emailmd with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/anypost/emailmd'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/anypost--emailmd/badge.svg)](/listings/anypost--emailmd)

HTML

<a href="/listings/anypost--emailmd"><img src="/api/listings/anypost--emailmd/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

npm install emailmd

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 120 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # emailmd
  2. ### Write markdown. Ship emails. No HTMHELL.
  3. emailmd converts markdown into responsive, email-safe HTML that works across Gmail, Outlook, Apple Mail, Yahoo, and every other client.
  4. ![emailmd](https://imgs.emailmd.dev/ss/github_splash.png?1)
  5. ## Install
  6. ```bash
  7. npm install emailmd
  8. ```
  9. ## Quick Start
  10. ```typescript
  11. import { render } from "emailmd";
  12. const { html, text } = await render(`
  13. # Welcome!
  14. Thanks for signing up.
  15. [Get Started](https://example.com){button}
  16. `);
  17. // html → complete email-safe HTML
  18. // text → plain text version for text/plain MIME part
  19. ```
  20. > **v0.3.0 migration:** `render()` is now async. Update calls from `render(md)` to `await render(md)`. Requires Node 20+ (MJML 5).
  21. ## Charts & Data
  22. Bar charts, progress meters, sparklines, KPI tiles, step trackers, and star ratings, each written as a plain markdown list:
  23. ```markdown
  24. ::: chart
  25. - Spotify: 16,900
  26. - Apple Podcasts: 12,400
  27. - Web player: 6,200
  28. - RSS: 2,900
  29. :::
  30. ```
  31. ![KPI tiles, a bar chart and a sparkline, rendered by emailmd from plain markdown lists](https://imgs.emailmd.dev/ss/chart_showcase.png?1)
  32. 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](https://www.emailmd.dev/docs/directives).
  33. ## CLI
  34. emailmd also ships with a command-line interface.
  35. ```bash
  36. # Render to HTML
  37. emailmd input.md
  38. # Write to file
  39. emailmd input.md -o output.html
  40. # Plain text output
  41. emailmd input.md --text
  42. # Pipe from another command
  43. echo "# Hello" | emailmd
  44. ```
  45. Run `emailmd --help` for all options.
  46. ## React
  47. [`@emailmd/react`](https://www.emailmd.dev/docs/react) provides a live-preview hook (`useEmailmd`), an `<EmailPreview />` iframe component, and `<EmailmdBuilder />` — the full [builder](https://www.emailmd.dev/builder) as a drop-in component for your own app.
  48. ```bash
  49. npm install @emailmd/react emailmd
  50. ```
  51. ## Learn More
  52. - [Docs](https://www.emailmd.dev/docs) — full syntax reference, theming, frontmatter, directives, and API
  53. - [Templates](https://www.emailmd.dev/templates) — ready-made email templates you can copy and customize
  54. - [Builder](https://www.emailmd.dev/builder) — live editor to write and preview emails in your browser
  55. ## MCP
  56. emailmd ships a [Model Context Protocol](https://modelcontextprotocol.io) 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:
  57. ```bash
  58. # Hosted (Streamable HTTP)
  59. https://www.emailmd.dev/api/mcp
  60. # Or run it locally over stdio
  61. npx emailmd mcp
  62. ```
  63. Published to the official MCP registry as `dev.emailmd/emailmd`. See the [MCP docs](https://www.emailmd.dev/docs/mcp) for per-client setup.
  64. ## AI
  65. Prefer plain context over tools? emailmd is just markdown, so AI is great at writing templates. Feed the full docs to your AI tool:
  66. ```
  67. https://www.emailmd.dev/llms-full.txt
  68. ```
  69. ## Contributing
  70. Contributions are welcome! Feel free to open an [issue](https://github.com/anypost/emailmd/issues) or submit a [pull request](https://github.com/anypost/emailmd/pulls).
  71. > 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](https://www.emailmd.dev/docs/stability) for what the semver contract covers.
  72. ## Acknowledgements
  73. - Built with [MJML](https://mjml.io) under the hood
  74. - Sponsored by [Anypost](https://anypost.com/)
  75. ## License
  76. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.