✂️ trimail

Parse email threads and separate the real content from signatures, quotes, and reply chains.

Trimail takes raw email content (HTML or plain text) and returns the actual message body — stripped of quoted replies, forwarded threads, signature blocks, and tracking pixels.

Installation

npm install trimail

Quick Start

import { trimail } from "trimail";

// HTML email (default)
const result = trimail(emailHtmlContent);

console.log(result.body); // Clean email body
console.log(result.signature); // Stripped content, or null

API

trimail(content: string, options?: TrimailOptions): TrimailResult

Parameter	Type	Default	Description
`content`	`string`	—	The raw email content
`options.format`	`"html" \| "text"`	`"html"`	Input format

Return Type

interface TrimailResult {
  body: string; // The clean email content
  signature: string | null; // Stripped signatures, quotes, and replies
}

Usage

HTML Emails

import { trimail } from "trimail";

const html = `
  <div>Sounds good, let's do it!</div>
  <div class="gmail_quote">
    <blockquote>Can we schedule a call for tomorrow?</blockquote>
  </div>
`;

const { body, signature } = trimail(html);
// body:      '<div>Sounds good, let\'s do it!</div>'
// signature: '<div class="gmail_quote">...</div>'

Plain Text Emails

const { body, signature } = trimail(
  `Got it, thanks!\n\nOn Mon, Jan 6 John wrote:\n> Original message`,
  { format: "text" }
);
// body:      'Got it, thanks!'
// signature: 'On Mon, Jan 6 John wrote:\n> Original message'

📧 Supported Email Clients

Client	Quotes	Signatures
Gmail	✅	✅
Outlook (Desktop & Mobile)	✅	✅
Apple Mail	✅	✅
Proton Mail	✅	✅
Shortwave	—	✅
Front	—	✅

Additionally Detected

-- signature delimiters (RFC 3676)
Common sign-offs — Regards, Thanks, Cheers, Sincerely, etc.
Forwarded message headers
Inline > quoting
Table-based corporate signatures (titles, disclaimers, phone numbers)
Tracking pixels (1×0 / 0×1 images)

🌍 Multilingual Quote Headers

Trimail detects "On ... wrote:" reply headers in 8 languages:

Language	Pattern
English	On ... wrote:
German	Am ... schrieb:
French	Le ... a écrit:
Spanish	El ... escribió:
Italian	Il ... ha scritto:
Portuguese	Em ... escreveu:
Dutch	Op ... schreef:
Ukrainian	... написав/написала:

License

MIT