kyoji2 · kyoji2 · Sep 9, 2026 · Sep 9, 2026
diff --git a/README.md b/README.md
@@ -64,6 +64,7 @@ intercom conversation search --state open
 intercom conversation get <id>
 intercom conversation reply <id> --admin <admin-id> --body "Internal triage note" --type note
 intercom conversation reply <id> --admin <admin-id> --body-file ./reply.html --type note
+intercom conversation reply <id> --admin <admin-id> --body-file ./reply.md --body-format markdown
 intercom conversation close <id> --admin <admin-id>
 
 # Manage companies
@@ -89,6 +90,7 @@ intercom ticket search --state open
 intercom ticket get <id>
 intercom ticket reply <id> --admin <admin-id> --body "We're on it!" --type comment
 intercom ticket reply <id> --admin <admin-id> --body-file ./reply.txt --type comment
+intercom ticket reply <id> --admin <admin-id> --body "# Update" --body-format markdown
 intercom ticket reply <id> --admin <admin-id> --body "Internal note" --json '{"message_type":"note"}'
 intercom ticket close <id> --admin <admin-id>
 
@@ -138,7 +140,7 @@ intercom ticket-type list
 | `intercom conversation snooze <id>` | Snooze conversation |
 | `intercom conversation convert <id>` | Convert conversation to ticket |
 
-`intercom conversation reply` requires exactly one of `--body <body>` or `--body-file <path>` (read as UTF-8), and supports `--type <comment|note>` and `--json <json>`.
+`intercom conversation reply` requires exactly one of `--body <body>` or `--body-file <path>` (read as UTF-8), and supports `--body-format markdown`, `--type <comment|note>`, and `--json <json>`. Omitting `--body-format` preserves the supplied body unchanged; Markdown is rendered with source HTML escaped and soft line breaks preserved as newlines (not `<br>`).
 Message type precedence: `--type` > `--json.message_type` > `comment`.
 
 ### Companies
@@ -197,7 +199,7 @@ Message type precedence: `--type` > `--json.message_type` > `comment`.
 | `intercom ticket close <id>` | Close a ticket |
 | `intercom ticket assign <id>` | Assign ticket to admin/team |
 
-`intercom ticket reply` requires exactly one of `--body <body>` or `--body-file <path>` (read as UTF-8), and supports `--type <comment|note>` and `--json <json>`.
+`intercom ticket reply` requires exactly one of `--body <body>` or `--body-file <path>` (read as UTF-8), and supports `--body-format markdown`, `--type <comment|note>`, and `--json <json>`. Omitting `--body-format` preserves the supplied body unchanged; Markdown is rendered with source HTML escaped and soft line breaks preserved as newlines (not `<br>`).
 Message type precedence: `--type` > `--json.message_type` > `comment`.
 
 ### Ticket Types

diff --git a/bun.lock b/bun.lock
diff --git a/package.json b/package.json
@@ -48,12 +48,14 @@
     "@toon-format/toon": "^2.1.0",
     "commander": "^14.0.2",
     "intercom-client": "^7.0.1",
+    "markdown-it": "^15.0.1",
     "ora": "^9.0.0",
     "zod": "^4.3.5"
   },
   "devDependencies": {
     "@biomejs/biome": "^2.3.11",
-    "@types/bun": "latest"
+    "@types/bun": "latest",
+    "@types/markdown-it": "^14.2.0"
   },
   "peerDependencies": {
     "typescript": "^5"

diff --git a/src/cli/registry.ts b/src/cli/registry.ts
@@ -430,6 +430,7 @@ export function registerCommands(program: Command, ctx: RegisterContext): void {
         options: [
           { flags: "--body <body>", description: "Reply message body" },
           { flags: "--body-file <path>", description: "Read reply message body from a UTF-8 file" },
+          { flags: "--body-format <format>", description: "Body format (markdown renders Markdown to HTML)" },
           { flags: "--type <type>", description: "Message type (comment, note)" },
           { flags: "--json <json>", description: "Additional reply data as JSON" },
         ],
@@ -440,6 +441,7 @@ export function registerCommands(program: Command, ctx: RegisterContext): void {
             adminId: options.admin as string,
             body: options.body as string | undefined,
             bodyFile: options.bodyFile as string | undefined,
+            bodyFormat: options.bodyFormat as string | undefined,
             messageType: options.type as string | undefined,
             json: options.json as string | undefined,
           });
@@ -849,6 +851,7 @@ export function registerCommands(program: Command, ctx: RegisterContext): void {
         options: [
           { flags: "--body <body>", description: "Reply message body" },
           { flags: "--body-file <path>", description: "Read reply message body from a UTF-8 file" },
+          { flags: "--body-format <format>", description: "Body format (markdown renders Markdown to HTML)" },
           { flags: "--type <type>", description: "Message type (comment, note)" },
           { flags: "--json <json>", description: "Additional reply data as JSON" },
         ],
@@ -859,6 +862,7 @@ export function registerCommands(program: Command, ctx: RegisterContext): void {
             adminId: options.admin as string,
             body: options.body as string | undefined,
             bodyFile: options.bodyFile as string | undefined,
+            bodyFormat: options.bodyFormat as string | undefined,
             messageType: options.type as string | undefined,
             json: options.json as string | undefined,
           });

diff --git a/src/commands/conversations.ts b/src/commands/conversations.ts
@@ -24,6 +24,7 @@ export interface ConversationReplyOptions extends GlobalOptions {
   adminId: string;
   body?: string;
   bodyFile?: string;
+  bodyFormat?: string;
   messageType?: string;
   json?: string;
 }
@@ -204,7 +205,11 @@ export async function cmdConversationSearch(options: ConversationSearchOptions):
 }
 
 export async function cmdConversationReply(options: ConversationReplyOptions): Promise<void> {
-  const body = await resolveReplyBody({ body: options.body, bodyFile: options.bodyFile });
+  const body = await resolveReplyBody({
+    body: options.body,
+    bodyFile: options.bodyFile,
+    bodyFormat: options.bodyFormat,
+  });
   const token = await requireToken(options.configDir);
   const spinner = ora("Sending reply...").start();
 

diff --git a/src/commands/replyBody.ts b/src/commands/replyBody.ts
@@ -1,11 +1,30 @@
 import { readFile } from "node:fs/promises";
+import MarkdownIt from "markdown-it";
 import { CLIError } from "../utils/index.ts";
 
 export type ReplyBodyInput = {
   body?: string;
   bodyFile?: string;
+  bodyFormat?: string;
 };
 
+const markdown = new MarkdownIt({
+  html: false,
+  breaks: false,
+});
+
+function renderReplyBody(body: string, bodyFormat?: string): string {
+  if (bodyFormat === undefined) {
+    return body;
+  }
+
+  if (bodyFormat !== "markdown") {
+    throw new CLIError(`Unsupported --body-format value: ${bodyFormat}`, 400, "Use markdown.");
+  }
+
+  return markdown.render(body);
+}
+
 export async function resolveReplyBody(input: ReplyBodyInput): Promise<string> {
   const hasBody = input.body !== undefined;
   const hasBodyFile = input.bodyFile !== undefined;
@@ -15,15 +34,15 @@ export async function resolveReplyBody(input: ReplyBodyInput): Promise<string> {
   }
 
   if (hasBody) {
-    return input.body as string;
+    return renderReplyBody(input.body as string, input.bodyFormat);
   }
 
   try {
     const body = await readFile(input.bodyFile as string, "utf8");
     if (body.length === 0) {
       throw new CLIError(`Body file is empty: ${input.bodyFile}`, 400);
     }
-    return body;
+    return renderReplyBody(body, input.bodyFormat);
   } catch (error) {
     if (error instanceof CLIError) {
       throw error;

diff --git a/src/commands/tickets.ts b/src/commands/tickets.ts
@@ -44,6 +44,7 @@ export interface TicketReplyOptions extends GlobalOptions {
   adminId: string;
   body?: string;
   bodyFile?: string;
+  bodyFormat?: string;
   messageType?: string;
   json?: string;
 }
@@ -304,7 +305,11 @@ export async function cmdTicketSearch(options: TicketSearchOptions): Promise<voi
 }
 
 export async function cmdTicketReply(options: TicketReplyOptions): Promise<void> {
-  const body = await resolveReplyBody({ body: options.body, bodyFile: options.bodyFile });
+  const body = await resolveReplyBody({
+    body: options.body,
+    bodyFile: options.bodyFile,
+    bodyFormat: options.bodyFormat,
+  });
   const token = await requireToken(options.configDir);
   const spinner = ora("Sending reply...").start();
 

diff --git a/tests/cli.test.ts b/tests/cli.test.ts
@@ -74,11 +74,12 @@ describe("CLI Integration", () => {
       expect(stdout).toContain("close");
     });
 
-    test("conversation reply --help shows body input, --type, and --json options", async () => {
+    test("conversation reply --help shows body input, format, --type, and --json options", async () => {
       const { stdout } = await cli("conversation reply --help");
 
       expect(stdout).toContain("--body");
       expect(stdout).toContain("--body-file");
+      expect(stdout).toContain("--body-format");
       expect(stdout).toContain("--type");
       expect(stdout).toContain("--json");
     });
@@ -125,11 +126,12 @@ describe("CLI Integration", () => {
       expect(stdout).toContain("get");
     });
 
-    test("ticket reply --help shows body input, --type, and --json options", async () => {
+    test("ticket reply --help shows body input, format, --type, and --json options", async () => {
       const { stdout } = await cli("ticket reply --help");
 
       expect(stdout).toContain("--body");
       expect(stdout).toContain("--body-file");
+      expect(stdout).toContain("--body-format");
       expect(stdout).toContain("--type");
       expect(stdout).toContain("--json");
     });
@@ -160,6 +162,15 @@ describe("CLI Integration", () => {
 
       expect(exitCode).not.toBe(0);
     });
+
+    test("unsupported reply body format exits with a clear error", async () => {
+      const { exitCode, stderr } = await cli(
+        "conversation reply conversation-id --admin admin-id --body reply --body-format html",
+      );
+
+      expect(exitCode).not.toBe(0);
+      expect(stderr).toContain("Unsupported --body-format value: html");
+    });
   });
 
   describe("dry-run mode", () => {
@@ -206,6 +217,40 @@ describe("CLI Integration", () => {
       }
     });
 
+    test("conversation reply renders Markdown in its final dry-run payload", async () => {
+      const body = "# Status\nSoft line";
+      const proc = spawn({
+        cmd: [
+          "bun",
+          "run",
+          "src/index.ts",
+          "--dry-run",
+          "conversation",
+          "reply",
+          "conversation-id",
+          "--admin",
+          "admin-id",
+          "--body",
+          body,
+          "--body-format",
+          "markdown",
+          "--type",
+          "note",
+          "--json",
+          '{"message_type":"comment"}',
+        ],
+        env: { ...process.env, INTERCOM_ACCESS_TOKEN: "test-token" },
+        stdout: "pipe",
+        stderr: "pipe",
+      });
+      const stdout = await new Response(proc.stdout).text();
+      const exitCode = await proc.exited;
+
+      expect(exitCode).toBe(0);
+      expect(stdout).toContain(JSON.stringify("<h1>Status</h1>\n<p>Soft line</p>\n"));
+      expect(stdout).toContain('"message_type": "note"');
+    });
+
     test("ticket reply reads a body file and displays its final payload", async () => {
       const directory = await mkdtemp(join(tmpdir(), "intercom-cli-dry-run-"));
       const bodyFile = join(directory, "reply.txt");
@@ -244,6 +289,35 @@ describe("CLI Integration", () => {
         await rm(directory, { recursive: true, force: true });
       }
     });
+
+    test("ticket reply renders Markdown in its final dry-run payload", async () => {
+      const proc = spawn({
+        cmd: [
+          "bun",
+          "run",
+          "src/index.ts",
+          "--dry-run",
+          "ticket",
+          "reply",
+          "ticket-id",
+          "--admin",
+          "admin-id",
+          "--body",
+          "**Resolved**",
+          "--body-format",
+          "markdown",
+        ],
+        env: { ...process.env, INTERCOM_ACCESS_TOKEN: "test-token" },
+        stdout: "pipe",
+        stderr: "pipe",
+      });
+      const stdout = await new Response(proc.stdout).text();
+      const exitCode = await proc.exited;
+
+      expect(exitCode).toBe(0);
+      expect(stdout).toContain("[DRY RUN] client.tickets.reply");
+      expect(stdout).toContain(JSON.stringify("<p><strong>Resolved</strong></p>\n"));
+    });
   });
 
   describe("format option", () => {