From 1103f000fc803918f70eb180573e5eb35ed95ae6 Mon Sep 17 00:00:00 2001 From: Alexander Minges Date: Tue, 10 Feb 2026 22:41:29 +0100 Subject: [PATCH] docs(matrix): clarify m.text body plaintext fallback note --- nanobot/channels/matrix.py | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/nanobot/channels/matrix.py b/nanobot/channels/matrix.py index 35c4000..fcff534 100644 --- a/nanobot/channels/matrix.py +++ b/nanobot/channels/matrix.py @@ -183,6 +183,10 @@ def _build_matrix_text_content(text: str) -> dict[str, object]: """Build Matrix m.text payload with plaintext fallback and optional HTML.""" content: dict[str, object] = { "msgtype": "m.text", + # Note: When `formatted_body` is present, Matrix spec expects `body` to + # be its plaintext representation (fallback for clients without HTML). + # We currently keep raw text (often markdown) for simplicity. + # https://spec.matrix.org/v1.17/client-server-api/#mroommessage-msgtypes "body": text, # Matrix spec recommends always including m.mentions for message # semantics/interoperability, even when no mentions are present.