{
  "markdown": "# emailmd\n\n### Write markdown. Ship emails. No HTMHELL.\n\nemailmd converts markdown into responsive, email-safe HTML that works across Gmail, Outlook, Apple Mail, Yahoo, and every other client.\n\n![emailmd](https://imgs.emailmd.dev/ss/github_splash.png?1)\n\n## Install\n\n```bash\nnpm install emailmd\n```\n\n## Quick Start\n\n```typescript\nimport { render } from \"emailmd\";\n\nconst { html, text } = await render(`\n# Welcome!\n\nThanks for signing up.\n\n[Get Started](https://example.com){button}\n`);\n\n// html → complete email-safe HTML\n// text → plain text version for text/plain MIME part\n```\n\n> **v0.3.0 migration:** `render()` is now async. Update calls from `render(md)` to `await render(md)`. Requires Node 20+ (MJML 5).\n\n## Charts & Data\n\nBar charts, progress meters, sparklines, KPI tiles, step trackers, and star ratings, each written as a plain markdown list:\n\n```markdown\n::: chart\n- Spotify: 16,900\n- Apple Podcasts: 12,400\n- Web player: 6,200\n- RSS: 2,900\n:::\n```\n\n![KPI tiles, a bar chart and a sparkline, rendered by emailmd from plain markdown lists](https://imgs.emailmd.dev/ss/chart_showcase.png?1)\n\nThey 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).\n\n## CLI\n\nemailmd also ships with a command-line interface.\n\n```bash\n# Render to HTML\nemailmd input.md\n\n# Write to file\nemailmd input.md -o output.html\n\n# Plain text output\nemailmd input.md --text\n\n# Pipe from another command\necho \"# Hello\" | emailmd\n```\n\nRun `emailmd --help` for all options.\n\n## React\n\n[`@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.\n\n```bash\nnpm install @emailmd/react emailmd\n```\n\n## Learn More\n\n- [Docs](https://www.emailmd.dev/docs) — full syntax reference, theming, frontmatter, directives, and API\n- [Templates](https://www.emailmd.dev/templates) — ready-made email templates you can copy and customize\n- [Builder](https://www.emailmd.dev/builder) — live editor to write and preview emails in your browser\n\n## MCP\n\nemailmd 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:\n\n```bash\n# Hosted (Streamable HTTP)\nhttps://www.emailmd.dev/api/mcp\n\n# Or run it locally over stdio\nnpx emailmd mcp\n```\n\nPublished to the official MCP registry as `dev.emailmd/emailmd`. See the [MCP docs](https://www.emailmd.dev/docs/mcp) for per-client setup.\n\n## AI\n\nPrefer plain context over tools? emailmd is just markdown, so AI is great at writing templates. Feed the full docs to your AI tool:\n\n```\nhttps://www.emailmd.dev/llms-full.txt\n```\n\n## Contributing\n\nContributions 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).\n\n> 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.\n\n## Acknowledgements\n\n- Built with [MJML](https://mjml.io) under the hood\n- Sponsored by [Anypost](https://anypost.com/)\n\n## License\n\nMIT\n",
  "bytes": 3727,
  "sha": "16311a3707c6beaf341af7a9acd5a313a4f4011aa79917c4ea36d2af0b3d307d",
  "repo_slug": "anypost/emailmd",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_dev_emailmd_emailmd_d62d079b/readme"
}