From 9b7d360c4cd7b486983888eda570d2b14ffd68b7 Mon Sep 17 00:00:00 2001
From: Roomote <roomote@roomote.dev>
Date: Wed, 19 Aug 2026 02:40:07 +0000
Subject: [PATCH] docs(chat): document theme-aware Mermaid diagrams

---
 docs/basic-usage/the-chat-interface.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/basic-usage/the-chat-interface.md b/docs/basic-usage/the-chat-interface.md
index 0c6cb2d7..6a47dce9 100644
--- a/docs/basic-usage/the-chat-interface.md
+++ b/docs/basic-usage/the-chat-interface.md
@@ -59,6 +59,10 @@ For more productivity tips, check out our [Tips & Tricks](/tips-and-tricks) guid
 * **Copying Text:** You can copy text from the chat history by selecting it and using the standard copy command (Ctrl/Cmd + C).  Some elements, like code blocks, have a dedicated "Copy" button.
 * **Expanding and Collapsing**: Click on a message to expand or collapse it.
 
+### Mermaid Diagrams
+
+Zoo Code renders Mermaid diagrams directly in chat. Diagram backgrounds, labels, lines, and exported PNGs follow your active IDE color theme, including light and high-contrast themes. If you change themes while a conversation is open, existing diagrams update automatically.
+
 ---
 
 ## Status Indicators