feat: integrate professional HTML to Markdown conversion

- Replace custom HTML conversion with node-html-markdown library
- Provide three content formats: text, markdown, and html
- Update README with new features and output structure
- Remove redundant fields and clean up code
- Version bump to 2.11.8

Author: Derek Zen

CHANGELOG.md

@@ -1,3 +1,12 @@
+## [2.11.8](https://github.com/callzhang/n8n-nodes-imap/compare/v2.11.7...v2.11.8) (2025-01-XX)
+
+### Improvements
+
+* **Professional HTML to Markdown Conversion**: Replaced custom HTML conversion with `node-html-markdown` library
+* **Better Markdown Quality**: Now uses industry-standard library for more accurate and reliable HTML to Markdown conversion
+* **Simplified Code**: Removed custom HTML parsing logic in favor of proven library
+* **Three Content Formats**: Clean separation of text, markdown, and html fields
+
 ## [2.11.7](https://github.com/callzhang/n8n-nodes-imap/compare/v2.11.6...v2.11.7) (2025-01-XX)
 
 ### Features

README.md

@@ -1,6 +1,6 @@
 # <img src="nodes/Imap/node-imap-enhanced-icon.svg"  height="40"> n8n-nodes-imap-enhanced
 
-This is an enhanced n8n community node that adds support for [IMAP](https://en.wikipedia.org/wiki/Internet_Message_Access_Protocol) email servers with advanced features including custom labels, limit parameters, and structured email fields.
+This is an enhanced n8n community node that adds support for [IMAP](https://en.wikipedia.org/wiki/Internet_Message_Access_Protocol) email servers with advanced features including custom labels, limit parameters, and professional HTML to Markdown conversion.
 
 * [Installation](#installation)  
 * [Operations](#operations)  
@@ -27,7 +27,7 @@ NPMJS: [n8n-nodes-imap-enhanced](https://www.npmjs.com/package/n8n-nodes-imap-en
   * Rename a mailbox
   * ~Delete a mailbox~ (disabled due to danger of accidental data loss and no apparent use case)
 * Email
-  * Get list of emails in a mailbox **with limit parameter and enhanced structured fields**
+  * Get list of emails in a mailbox **with limit parameter and three content formats (text, markdown, html)**
   * Download attachments from an email
   * Move an email to another mailbox
   * Copy an email into another mailbox
@@ -38,10 +38,11 @@ NPMJS: [n8n-nodes-imap-enhanced](https://www.npmjs.com/package/n8n-nodes-imap-en
 
 ## New Features
 
-### Enhanced Email Fields
-- **Structured Output**: Returns title, from, to, cc, bcc, labels, content (text and HTML)
-- **Simplified HTML**: Converts text content to simplified HTML format
-- **All Email Metadata**: Includes date, messageId, size, and other envelope fields
+### Professional Content Processing
+- **Three Content Formats**: Returns `text`, `markdown`, and `html` fields for email body content
+- **Professional Markdown**: Uses `node-html-markdown` library for accurate HTML to Markdown conversion
+- **Clean Text**: Converts HTML to readable plain text with proper formatting
+- **Standard Fields**: Always includes flags/labels and structured envelope data
 
 ### Custom Labels Support
 - **Search by Custom Labels**: Search emails using custom labels/keywords
@@ -53,6 +54,27 @@ NPMJS: [n8n-nodes-imap-enhanced](https://www.npmjs.com/package/n8n-nodes-imap-en
 - **Mailbox List Limit**: Control maximum number of mailboxes returned
 - **Performance Optimization**: Prevents excessive data fetching
 
+### Output Structure
+```json
+{
+  "seq": 415,
+  "uid": 18718,
+  "mailboxPath": "INBOX",
+  "envelope": {
+    "subject": "Email Subject",
+    "from": [{"name": "Sender", "address": "[email protected]"}],
+    "to": [{"name": "Recipient", "address": "[email protected]"}],
+    "date": "2025-01-XX",
+    "messageId": "<message-id>"
+  },
+  "labels": ["\\Seen"],
+  "size": 12345,
+  "text": "Plain text content",
+  "markdown": "# Header\n\n**Bold** text",
+  "html": "<p>HTML content</p>"
+}
+```
+
 ## Credentials
 
 Currently, this node supports only basic authentication (username and password).  

nodes/Imap/operations/email/functions/EmailGetList.ts

@@ -6,6 +6,7 @@ import { getMailboxPathFromNodeParameter, parameterSelectMailbox } from "../../.
 import { emailSearchParameters, getEmailSearchParametersFromNode } from "../../../utils/EmailSearchParameters";
 import { simpleParser } from 'mailparser';
 import { getEmailPartsInfoRecursive } from "../../../utils/EmailParts";
+import { NodeHtmlMarkdown } from 'node-html-markdown';
 
 
 enum EmailParts {
@@ -48,54 +49,40 @@ function textToSimplifiedHtml(text: string): string {
     .replace(/\r/g, '<br>');
 }
 
-function formatEmailAddresses(addresses: any[]): string[] {
-  if (!addresses || !Array.isArray(addresses)) return [];
 
-  return addresses.map(addr => {
-    if (typeof addr === 'string') return addr;
-    if (addr.name && addr.address) {
-      return `${addr.name} <${addr.address}>`;
-    }
-    return addr.address || '';
-  }).filter(addr => addr);
+// Initialize HTML to Markdown converter
+const nhm = new NodeHtmlMarkdown();
+
+function htmlToMarkdown(html: string): string {
+  if (!html) return '';
+  return nhm.translate(html);
 }
 
-function simplifyHtmlToReadable(html: string): string {
+function htmlToText(html: string): string {
   if (!html) return '';
 
   // Remove script and style elements completely
-  let simplified = html.replace(/<script[^>]*>[\s\S]*?<\/script>/gi, '');
-  simplified = simplified.replace(/<style[^>]*>[\s\S]*?<\/style>/gi, '');
+  let text = html.replace(/<script[^>]*>[\s\S]*?<\/script>/gi, '');
+  text = text.replace(/<style[^>]*>[\s\S]*?<\/style>/gi, '');
 
-  // Convert common HTML elements to readable format
-  simplified = simplified
-    // Convert headers to readable format
-    .replace(/<h[1-6][^>]*>(.*?)<\/h[1-6]>/gi, '\n\n$1\n' + '='.repeat(50) + '\n')
-    // Convert paragraphs
-    .replace(/<p[^>]*>(.*?)<\/p>/gi, '\n\n$1\n')
+  // Convert HTML elements to plain text
+  text = text
     // Convert line breaks
     .replace(/<br[^>]*>/gi, '\n')
-    // Convert divs to line breaks
+    // Convert paragraphs
+    .replace(/<p[^>]*>(.*?)<\/p>/gi, '\n\n$1\n\n')
+    // Convert headers
+    .replace(/<h[1-6][^>]*>(.*?)<\/h[1-6]>/gi, '\n\n$1\n\n')
+    // Convert divs
     .replace(/<div[^>]*>(.*?)<\/div>/gi, '\n$1\n')
     // Convert lists
     .replace(/<ul[^>]*>(.*?)<\/ul>/gi, '\n$1\n')
     .replace(/<ol[^>]*>(.*?)<\/ol>/gi, '\n$1\n')
     .replace(/<li[^>]*>(.*?)<\/li>/gi, '• $1\n')
     // Convert blockquotes
     .replace(/<blockquote[^>]*>(.*?)<\/blockquote>/gi, '\n> $1\n')
-    // Convert links to readable format
+    // Convert links to plain text with URL
     .replace(/<a[^>]*href=["']([^"']*)["'][^>]*>(.*?)<\/a>/gi, '$2 ($1)')
-    // Convert emphasis
-    .replace(/<(strong|b)[^>]*>(.*?)<\/(strong|b)>/gi, '**$2**')
-    .replace(/<(em|i)[^>]*>(.*?)<\/(em|i)>/gi, '*$2*')
-    // Convert code
-    .replace(/<code[^>]*>(.*?)<\/code>/gi, '`$1`')
-    .replace(/<pre[^>]*>(.*?)<\/pre>/gi, '\n```\n$1\n```\n')
-    // Convert tables to readable format
-    .replace(/<table[^>]*>(.*?)<\/table>/gi, '\n$1\n')
-    .replace(/<tr[^>]*>(.*?)<\/tr>/gi, '\n$1\n')
-    .replace(/<td[^>]*>(.*?)<\/td>/gi, '$1 | ')
-    .replace(/<th[^>]*>(.*?)<\/th>/gi, '$1 | ')
     // Remove all remaining HTML tags
     .replace(/<[^>]*>/g, '')
     // Decode HTML entities
@@ -113,7 +100,7 @@ function simplifyHtmlToReadable(html: string): string {
     .replace(/\n /g, '\n') // Remove leading spaces from lines
     .replace(/ \n/g, '\n'); // Remove trailing spaces from lines
 
-  return simplified.trim();
+  return text.trim();
 }
 
 
@@ -214,8 +201,8 @@ export const getEmailsListOperation: IResourceOperationDef = {
       name: 'enhancedFields',
       type: 'boolean',
       default: true,
-      description: 'Whether to include email body content (text and HTML) in the results',
-      hint: 'Returns both text and HTML versions of the email body content',
+      description: 'Whether to include email body content in the results',
+      hint: 'Returns text, markdown, and html fields with email body content',
     }
   ],
   async executeImapAction(context: IExecuteFunctions, itemIndex: number, client: ImapFlow): Promise<INodeExecutionData[] | null> {
@@ -322,18 +309,7 @@ export const getEmailsListOperation: IResourceOperationDef = {
         item_json.size = email.size;
       }
 
-      // Always include structured fields from envelope (clean format)
-      if (email.envelope) {
-        item_json.title = email.envelope.subject || '';
-        item_json.from = formatEmailAddresses(email.envelope.from || []);
-        item_json.to = formatEmailAddresses(email.envelope.to || []);
-        item_json.cc = formatEmailAddresses(email.envelope.cc || []);
-        item_json.bcc = formatEmailAddresses(email.envelope.bcc || []);
-        item_json.replyTo = formatEmailAddresses(email.envelope.replyTo || []);
-        item_json.date = email.envelope.date;
-        item_json.messageId = email.envelope.messageId;
-        item_json.inReplyTo = email.envelope.inReplyTo;
-      }
+      // Note: All envelope fields are already included in the envelope object above
 
       // process the headers
       if (includeParts.includes(EmailParts.Headers)) {
@@ -409,11 +385,11 @@ export const getEmailsListOperation: IResourceOperationDef = {
             if (textContent.content) {
               item_json.textContent = await streamToString(textContent.content);
 
-              // if include body is enabled, also provide simplified HTML version
+              // if include body is enabled, provide text content
               if (enhancedFields) {
-                item_json.contentText = item_json.textContent;
-                item_json.contentHtml = textToSimplifiedHtml(item_json.textContent);
-                item_json.contentReadable = item_json.textContent; // Text content is already readable
+                item_json.text = item_json.textContent;
+                item_json.markdown = item_json.textContent; // Plain text is already readable
+                item_json.html = textToSimplifiedHtml(item_json.textContent);
               }
             }
           }
@@ -428,25 +404,24 @@ export const getEmailsListOperation: IResourceOperationDef = {
             if (htmlContent.content) {
               item_json.htmlContent = await streamToString(htmlContent.content);
 
-              // if include body is enabled, also provide the HTML content
+              // if include body is enabled, provide HTML content
               if (enhancedFields) {
-                item_json.contentHtml = item_json.htmlContent;
-                // if we don't have text content, create readable text from the HTML content
-                if (!item_json.contentText) {
-                  item_json.contentText = simplifyHtmlToReadable(item_json.htmlContent);
+                item_json.html = item_json.htmlContent;
+                item_json.markdown = htmlToMarkdown(item_json.htmlContent);
+                // if we don't have text content, create plain text from the HTML content
+                if (!item_json.text) {
+                  item_json.text = htmlToText(item_json.htmlContent);
                 }
-                // Always provide a readable version of the HTML content
-                item_json.contentReadable = simplifyHtmlToReadable(item_json.htmlContent);
               }
             }
           }
         }
 
         // if include body is enabled but no content was found, set empty values
-        if (enhancedFields && !item_json.contentText && !item_json.contentHtml) {
-          item_json.contentText = '';
-          item_json.contentHtml = '';
-          item_json.contentReadable = '';
+        if (enhancedFields && !item_json.text && !item_json.html) {
+          item_json.text = '';
+          item_json.markdown = '';
+          item_json.html = '';
         }
       }
 

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "n8n-nodes-imap-enhanced",
-  "version": "2.11.7",
+  "version": "2.11.8",
   "description": "Enhanced IMAP node with custom labels support, limit parameters, and structured email fields for n8n workflows.",
   "keywords": [
     "n8n-community-node-package"
@@ -64,6 +64,7 @@
   "dependencies": {
     "imapflow": "^1.0.188",
     "mailparser": "^3.7.3",
+    "node-html-markdown": "^1.3.0",
     "nodemailer": "^6.10.1"
   }
 }