@verygoodplugins/mcp-freescout 1.1.0 → 1.1.2

package/.claude/settings.local.json

@@ -1,7 +1,8 @@
 {
   "permissions": {
     "allow": [
-      "Bash(npx @verygoodplugins/mcp-freescout@1.0.1:*)"
+      "Bash(npx @verygoodplugins/mcp-freescout@1.0.1:*)",
+      "Bash(node:*)"
     ],
     "deny": []
   }

package/README.md

@@ -143,7 +143,9 @@ Fetch a FreeScout ticket with all its details and conversation threads.
 }
 ```
 
-<img width="575" height="751" alt="image" src="https://github.com/user-attachments/assets/0144056d-f6d6-4275-9f55-dade0be3ba8c" />
+**Example: Fetching a FreeScout ticket with conversation threads**
+
+![FreeScout ticket details and conversation threads displayed in Cursor chat interface](https://github.com/user-attachments/assets/0144056d-f6d6-4275-9f55-dade0be3ba8c)
 
 
 #### `freescout_analyze_ticket`
@@ -160,6 +162,10 @@ Analyze a ticket to determine issue type, root cause, and suggested solutions.
 - Root cause analysis
 - Bug vs feature request vs third-party issue determination
 
+**Example: Intelligent ticket analysis with issue classification**
+
+![Ticket analysis showing issue type, root cause, and implementation recommendations](https://github.com/user-attachments/assets/19080021-1f29-45a4-8601-556b55d379c3)
+
 #### `freescout_add_note`
 Add an internal note to a ticket for team communication.
 
@@ -168,8 +174,6 @@ Add an internal note to a ticket for team communication.
 - `note` (required): The note content
 - `userId` (optional): User ID for the note (defaults to env setting)
 
-<img width="570" height="691" alt="image" src="https://github.com/user-attachments/assets/19080021-1f29-45a4-8601-556b55d379c3" />
-
 #### `freescout_update_ticket`
 Update ticket status and/or assignment.
 
@@ -178,15 +182,44 @@ Update ticket status and/or assignment.
 - `status` (optional): New status ('active', 'pending', 'closed', 'spam')
 - `assignTo` (optional): User ID to assign the ticket to
 
-#### `freescout_draft_reply`
-Generate a customer reply based on ticket analysis and fix description.
+#### `freescout_create_draft_reply`
+Create a draft reply in FreeScout that can be edited before sending. This tool lets the LLM generate the reply content and saves it directly to FreeScout as a draft. **Automatically converts Markdown formatting to HTML** for proper display in FreeScout.
+
+**Parameters:**
+- `ticket` (required): Ticket ID, number, or FreeScout URL
+- `replyText` (required): The draft reply content (generated by the LLM, supports Markdown formatting)
+- `userId` (optional): User ID creating the draft (defaults to env setting)
+
+**Markdown Support:**
+- **Bold text**: `**text**` or `__text__` → **text**
+- *Italic text*: `*text*` or `_text_` → *text*
+- `Code`: `` `code` `` → `code`
+- Numbered lists: `1. item` → proper ordered lists
+- Bullet lists: `- item` or `* item` → proper unordered lists
+- Line breaks: Double newlines create paragraphs, single newlines create line breaks
+
+**Workflow:**
+1. Use `freescout_get_ticket_context` to get customer info and ticket details
+2. Let the LLM craft a personalized reply using Markdown formatting
+3. Use `freescout_create_draft_reply` to save the draft in FreeScout (Markdown automatically converted to HTML)
+4. Review and edit the draft in FreeScout before sending
+
+**Example: Draft reply workflow with personalized customer response**
+
+![Draft reply generation showing personalized customer message with ticket context](https://github.com/user-attachments/assets/a4f9eb6c-3204-4744-8aed-8d16d7c7641c)
+
+#### `freescout_get_ticket_context`
+Get ticket context and customer information to help craft personalized replies.
 
 **Parameters:**
 - `ticket` (required): Ticket ID, number, or FreeScout URL
-- `fixDescription` (optional): Description of the implemented fix
-- `isExplanatory` (optional): Whether this is an explanatory reply (no code changes)
 
-<img width="570" height="204" alt="image" src="https://github.com/user-attachments/assets/781d4a09-5605-4271-ac14-e133dd9f383d" />
+**Returns:**
+- Customer name and email
+- Ticket subject and status
+- Issue description and analysis
+- Recent customer and team messages
+- Analysis results (bug vs feature vs third-party issue)
 
 #### `freescout_search_tickets`
 Search for tickets across your FreeScout instance.
@@ -280,19 +313,33 @@ Fixes the validation error reported in the checkout process.
   ticketId: '12345'  // Automatically adds FreeScout link to PR
 });
 
-// 3. Draft a customer reply
-const reply = await mcp.callTool('freescout_draft_reply', {
-  ticket: '12345',
-  fixDescription: 'Fixed the validation error in the checkout process'
+// 3. Get ticket context to craft a personalized reply
+const context = await mcp.callTool('freescout_get_ticket_context', {
+  ticket: '12345'
 });
 
-// 4. Add the draft as an internal note for review
-await mcp.callTool('freescout_add_note', {
+// 4. Create a draft reply directly in FreeScout (LLM generates the content with Markdown)
+await mcp.callTool('freescout_create_draft_reply', {
   ticket: '12345',
-  note: `Draft reply for customer:\n\n${reply}`
+  replyText: `Hi ${context.customer.name},
+
+Thank you for working through that validation issue with us! Your detailed report was really helpful.
+
+I've just implemented a fix that addresses the checkout validation error you experienced. The fix includes:
+
+1. **Improved validation logic** in the checkout process
+2. **Better error handling** for edge cases  
+3. **Additional safeguards** to prevent similar issues
+
+The fix has been submitted for review and will be included in the next plugin update. You'll receive the update through WordPress's automatic update system.
+
+Thanks again for your patience and for helping us improve the plugin!
+
+Best regards,
+[Your name]`
 });
 
-// 5. Update ticket status and assignment
+// 5. Update ticket status and assignment  
 await mcp.callTool('freescout_update_ticket', {
   ticket: '12345',
   status: 'active',
@@ -305,6 +352,38 @@ await mcp.callTool('git_remove_worktree', {
 });
 ```
 
+### Draft Reply Workflow
+```javascript
+// 1. Get ticket context for personalized reply
+const context = await mcp.callTool('freescout_get_ticket_context', {
+  ticket: '34811'
+});
+
+// 2. Create draft reply in FreeScout (LLM crafts the content)
+await mcp.callTool('freescout_create_draft_reply', {
+  ticket: '34811',
+  replyText: `Hi ${context.customer.name},
+
+Thank you for reporting the HighLevel OAuth authorization issue! Your experience with the EngageBay LiveChat plugin conflict has been really valuable.
+
+Based on what we learned from your case, I've added a new plugin conflict detection system to WP Fusion. In the next update (v3.46.7), users will see:
+
+🔍 **Plugin Conflict Detection**
+- Automatic detection of known conflicting plugins  
+- Warning messages before HighLevel authorization
+- Clear guidance when conflicts are detected
+
+This should prevent the confusion you experienced and help other users avoid similar issues.
+
+The update should be available within the next few weeks. Thanks for your patience and for helping us improve the plugin!
+
+Best regards,
+Jack`
+});
+
+// The draft is now saved in FreeScout and can be reviewed/edited before sending
+```
+
 ### Handling Non-Bug Issues
 ```javascript
 // For third-party issues or feature requests

package/dist/freescout-api.d.ts

@@ -3,6 +3,10 @@ export declare class FreeScoutAPI {
     private baseUrl;
     private apiKey;
     constructor(baseUrl: string, apiKey: string);
+    /**
+     * Convert Markdown formatting to HTML for FreeScout
+     */
+    private markdownToHtml;
     private request;
     getConversation(ticketId: string, includeThreads?: boolean): Promise<FreeScoutConversation>;
     addThread(ticketId: string, type: 'note' | 'message' | 'customer', text: string, userId?: number, state?: 'draft' | 'published'): Promise<FreeScoutThread>;

package/dist/freescout-api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"freescout-api.d.ts","sourceRoot":"","sources":["../src/freescout-api.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,qBAAqB,EACrB,oBAAoB,EACpB,eAAe,EAChB,MAAM,YAAY,CAAC;AAEpB,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAS;gBAEX,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;YAK7B,OAAO;IA6Bf,eAAe,CACnB,QAAQ,EAAE,MAAM,EAChB,cAAc,GAAE,OAAc,GAC7B,OAAO,CAAC,qBAAqB,CAAC;IAO3B,SAAS,CACb,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,EACrC,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,OAAO,GAAG,WAAW,GAC5B,OAAO,CAAC,eAAe,CAAC;IAqBrB,gBAAgB,CACpB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,eAAe,CAAC;IAIrB,kBAAkB,CACtB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE;QACP,MAAM,CAAC,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;QAClD,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GACA,OAAO,CAAC,qBAAqB,CAAC;IAQ3B,mBAAmB,CACvB,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,oBAAoB,CAAC,qBAAqB,CAAC,CAAC;IAUvD,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAQlD,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;CAoBxC"}
+{"version":3,"file":"freescout-api.d.ts","sourceRoot":"","sources":["../src/freescout-api.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,qBAAqB,EACrB,oBAAoB,EACpB,eAAe,EAChB,MAAM,YAAY,CAAC;AAEpB,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAS;gBAEX,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAK3C;;OAEG;IACH,OAAO,CAAC,cAAc;YAgIR,OAAO;IA6Bf,eAAe,CACnB,QAAQ,EAAE,MAAM,EAChB,cAAc,GAAE,OAAc,GAC7B,OAAO,CAAC,qBAAqB,CAAC;IAO3B,SAAS,CACb,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,EACrC,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,OAAO,GAAG,WAAW,GAC5B,OAAO,CAAC,eAAe,CAAC;IAqBrB,gBAAgB,CACpB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,eAAe,CAAC;IAMrB,kBAAkB,CACtB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE;QACP,MAAM,CAAC,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;QAClD,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GACA,OAAO,CAAC,qBAAqB,CAAC;IAQ3B,mBAAmB,CACvB,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,oBAAoB,CAAC,qBAAqB,CAAC,CAAC;IAUvD,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAQlD,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;CAoBxC"}

package/dist/freescout-api.js

@@ -6,6 +6,122 @@ export class FreeScoutAPI {
         this.baseUrl = baseUrl.replace(/\/$/, ''); // Remove trailing slash
         this.apiKey = apiKey;
     }
+    /**
+     * Convert Markdown formatting to HTML for FreeScout
+     */
+    markdownToHtml(text) {
+        // Convert bold text: **text** or __text__ -> <strong>text</strong>
+        let html = text
+            .replace(/\*\*(.*?)\*\*/g, '<strong>$1</strong>')
+            .replace(/__(.*?)__/g, '<strong>$1</strong>');
+        // Convert italic text: *text* or _text_ -> <em>text</em> (avoid conflicts with bold)
+        html = html.replace(/(?<!\*)\*([^*]+)\*(?!\*)/g, '<em>$1</em>');
+        html = html.replace(/(?<!_)_([^_]+)_(?!_)/g, '<em>$1</em>');
+        // Convert code: `text` -> <code>text</code>
+        html = html.replace(/`(.*?)`/g, '<code>$1</code>');
+        // Process the entire text to handle lists that span paragraph breaks
+        const lines = html.split('\n');
+        const processedLines = [];
+        let inOrderedList = false;
+        let inUnorderedList = false;
+        let currentParagraph = [];
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            const trimmedLine = line.trim();
+            // Check for empty lines (paragraph breaks)
+            if (!trimmedLine) {
+                // Check if the next non-empty line is also a list item
+                const nextListItemIndex = lines.slice(i + 1).findIndex(nextLine => {
+                    const nextTrimmed = nextLine.trim();
+                    return nextTrimmed && (/^\d+\.\s+/.test(nextTrimmed) || /^[-*]\s+/.test(nextTrimmed));
+                });
+                // If we're in a list and the next item is also a list item, continue the list
+                if ((inOrderedList || inUnorderedList) && nextListItemIndex !== -1) {
+                    continue; // Skip this empty line but keep the list open
+                }
+                // Close any current lists before starting new paragraph
+                if (inOrderedList) {
+                    processedLines.push('</ol>');
+                    inOrderedList = false;
+                }
+                if (inUnorderedList) {
+                    processedLines.push('</ul>');
+                    inUnorderedList = false;
+                }
+                // Process accumulated paragraph
+                if (currentParagraph.length > 0) {
+                    const paragraphContent = currentParagraph.join('<br>');
+                    processedLines.push(`<p>${paragraphContent}</p>`);
+                    currentParagraph = [];
+                }
+                // Skip extra empty lines
+                continue;
+            }
+            // Check for numbered list items
+            if (/^\d+\.\s+/.test(trimmedLine)) {
+                // Finish any current paragraph
+                if (currentParagraph.length > 0) {
+                    const paragraphContent = currentParagraph.join('<br>');
+                    processedLines.push(`<p>${paragraphContent}</p>`);
+                    currentParagraph = [];
+                }
+                if (!inOrderedList) {
+                    if (inUnorderedList) {
+                        processedLines.push('</ul>');
+                        inUnorderedList = false;
+                    }
+                    processedLines.push('<ol>');
+                    inOrderedList = true;
+                }
+                const content = trimmedLine.replace(/^\d+\.\s+/, '');
+                processedLines.push(`<li>${content}</li>`);
+            }
+            // Check for bullet list items
+            else if (/^[-*]\s+/.test(trimmedLine)) {
+                // Finish any current paragraph
+                if (currentParagraph.length > 0) {
+                    const paragraphContent = currentParagraph.join('<br>');
+                    processedLines.push(`<p>${paragraphContent}</p>`);
+                    currentParagraph = [];
+                }
+                if (!inUnorderedList) {
+                    if (inOrderedList) {
+                        processedLines.push('</ol>');
+                        inOrderedList = false;
+                    }
+                    processedLines.push('<ul>');
+                    inUnorderedList = true;
+                }
+                const content = trimmedLine.replace(/^[-*]\s+/, '');
+                processedLines.push(`<li>${content}</li>`);
+            }
+            // Regular line
+            else {
+                // Close any lists
+                if (inOrderedList) {
+                    processedLines.push('</ol>');
+                    inOrderedList = false;
+                }
+                if (inUnorderedList) {
+                    processedLines.push('</ul>');
+                    inUnorderedList = false;
+                }
+                // Add to current paragraph
+                currentParagraph.push(trimmedLine);
+            }
+        }
+        // Close any remaining lists
+        if (inOrderedList)
+            processedLines.push('</ol>');
+        if (inUnorderedList)
+            processedLines.push('</ul>');
+        // Process any remaining paragraph
+        if (currentParagraph.length > 0) {
+            const paragraphContent = currentParagraph.join('<br>');
+            processedLines.push(`<p>${paragraphContent}</p>`);
+        }
+        return processedLines.join('\n\n');
+    }
     async request(path, method = 'GET', body) {
         const url = `${this.baseUrl}/api${path}`;
         const headers = {
@@ -43,7 +159,9 @@ export class FreeScoutAPI {
         return this.request(`/conversations/${ticketId}/threads`, 'POST', body);
     }
     async createDraftReply(ticketId, text, userId) {
-        return this.addThread(ticketId, 'message', text, userId, 'draft');
+        // Convert Markdown formatting to HTML for proper display in FreeScout
+        const htmlText = this.markdownToHtml(text);
+        return this.addThread(ticketId, 'message', htmlText, userId, 'draft');
     }
     async updateConversation(ticketId, updates) {
         return this.request(`/conversations/${ticketId}`, 'PUT', updates);

package/dist/freescout-api.js.map

@@ -1 +1 @@
-{"version":3,"file":"freescout-api.js","sourceRoot":"","sources":["../src/freescout-api.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"freescout-api.js","sourceRoot":"","sources":["../src/freescout-api.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@verygoodplugins/mcp-freescout",
-  "version": "1.1.0",
+  "version": "1.1.2",
   "description": "MCP server for FreeScout ticket management and workflow automation",
   "main": "dist/index.js",
   "type": "module",

package/test-markdown.js

@@ -0,0 +1,150 @@
+// Quick test of the markdown converter
+const testInput = `Hi Victor,
+
+Thanks for helping us identify this issue! Based on your experience with the EngageBay LiveChat plugin conflict, we've implemented a solution to prevent this confusion for future users.
+
+**What we've added:**
+
+1. **Proactive Warning System** - When users have conflicting plugins installed (like EngageBay LiveChat, LeadConnector, or GHL Connect), WP Fusion will now display a warning message before they attempt OAuth authorization, letting them know these plugins may interfere with the connection process.
+
+2. **Enhanced Error Messages** - If the \`invalid_grant\` error does occur, users will now receive specific guidance about potential plugin conflicts rather than the cryptic error message you experienced.
+
+This improvement will be included in the next WP Fusion update and should help other users avoid the frustration you encountered. The system will specifically detect the EngageBay LiveChat plugin (and others we discover) and provide clear guidance on temporarily disabling them during the OAuth setup process.
+
+Thanks again for your patience in working through this issue and helping us identify the root cause. Your feedback directly led to this improvement that will benefit all WP Fusion users integrating with HighLevel!
+
+Best regards,
+Jack`;
+
+function markdownToHtml(text) {
+  // Convert bold text: **text** or __text__ -> <strong>text</strong>
+  let html = text
+    .replace(/\*\*(.*?)\*\*/g, '<strong>$1</strong>')
+    .replace(/__(.*?)__/g, '<strong>$1</strong>');
+  
+  // Convert italic text: *text* or _text_ -> <em>text</em> (avoid conflicts with bold)
+  html = html.replace(/(?<!\*)\*([^*]+)\*(?!\*)/g, '<em>$1</em>');
+  html = html.replace(/(?<!_)_([^_]+)_(?!_)/g, '<em>$1</em>');
+  
+  // Convert code: `text` -> <code>text</code>
+  html = html.replace(/`(.*?)`/g, '<code>$1</code>');
+  
+  // Process the entire text to handle lists that span paragraph breaks
+  const lines = html.split('\n');
+  const processedLines = [];
+  let inOrderedList = false;
+  let inUnorderedList = false;
+  let currentParagraph = [];
+  
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i];
+    const trimmedLine = line.trim();
+    
+    // Check for empty lines (paragraph breaks)
+    if (!trimmedLine) {
+      // Check if the next non-empty line is also a list item
+      const nextListItemIndex = lines.slice(i + 1).findIndex(nextLine => {
+        const nextTrimmed = nextLine.trim();
+        return nextTrimmed && (/^\d+\.\s+/.test(nextTrimmed) || /^[-*]\s+/.test(nextTrimmed));
+      });
+      
+      // If we're in a list and the next item is also a list item, continue the list
+      if ((inOrderedList || inUnorderedList) && nextListItemIndex !== -1) {
+        continue; // Skip this empty line but keep the list open
+      }
+      
+      // Close any current lists before starting new paragraph
+      if (inOrderedList) {
+        processedLines.push('</ol>');
+        inOrderedList = false;
+      }
+      if (inUnorderedList) {
+        processedLines.push('</ul>');
+        inUnorderedList = false;
+      }
+      
+      // Process accumulated paragraph
+      if (currentParagraph.length > 0) {
+        const paragraphContent = currentParagraph.join('<br>');
+        processedLines.push(`<p>${paragraphContent}</p>`);
+        currentParagraph = [];
+      }
+      
+      // Skip extra empty lines
+      continue;
+    }
+    
+    // Check for numbered list items
+    if (/^\d+\.\s+/.test(trimmedLine)) {
+      // Finish any current paragraph
+      if (currentParagraph.length > 0) {
+        const paragraphContent = currentParagraph.join('<br>');
+        processedLines.push(`<p>${paragraphContent}</p>`);
+        currentParagraph = [];
+      }
+      
+      if (!inOrderedList) {
+        if (inUnorderedList) {
+          processedLines.push('</ul>');
+          inUnorderedList = false;
+        }
+        processedLines.push('<ol>');
+        inOrderedList = true;
+      }
+      const content = trimmedLine.replace(/^\d+\.\s+/, '');
+      processedLines.push(`<li>${content}</li>`);
+    }
+    // Check for bullet list items
+    else if (/^[-*]\s+/.test(trimmedLine)) {
+      // Finish any current paragraph
+      if (currentParagraph.length > 0) {
+        const paragraphContent = currentParagraph.join('<br>');
+        processedLines.push(`<p>${paragraphContent}</p>`);
+        currentParagraph = [];
+      }
+      
+      if (!inUnorderedList) {
+        if (inOrderedList) {
+          processedLines.push('</ol>');
+          inOrderedList = false;
+        }
+        processedLines.push('<ul>');
+        inUnorderedList = true;
+      }
+      const content = trimmedLine.replace(/^[-*]\s+/, '');
+      processedLines.push(`<li>${content}</li>`);
+    }
+    // Regular line
+    else {
+      // Close any lists
+      if (inOrderedList) {
+        processedLines.push('</ol>');
+        inOrderedList = false;
+      }
+      if (inUnorderedList) {
+        processedLines.push('</ul>');
+        inUnorderedList = false;
+      }
+      
+      // Add to current paragraph
+      currentParagraph.push(trimmedLine);
+    }
+  }
+  
+  // Close any remaining lists
+  if (inOrderedList) processedLines.push('</ol>');
+  if (inUnorderedList) processedLines.push('</ul>');
+  
+  // Process any remaining paragraph
+  if (currentParagraph.length > 0) {
+    const paragraphContent = currentParagraph.join('<br>');
+    processedLines.push(`<p>${paragraphContent}</p>`);
+  }
+  
+  return processedLines.join('\n\n');
+}
+
+console.log('=== INPUT ===');
+console.log(testInput);
+console.log('\n=== OUTPUT ===');
+console.log(markdownToHtml(testInput));