From 632651aee2548a2c066b94915737422353f56ffb Mon Sep 17 00:00:00 2001
From: Peter Steinberger <steipete@gmail.com>
Date: Thu, 15 Jan 2026 00:37:04 +0000
Subject: [PATCH] docs: add markdown IR example

---
 docs/concepts/markdown-formatting.md | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/docs/concepts/markdown-formatting.md b/docs/concepts/markdown-formatting.md
index ae8889b73..da2c1b268 100644
--- a/docs/concepts/markdown-formatting.md
+++ b/docs/concepts/markdown-formatting.md
@@ -33,6 +33,28 @@ stay consistent across channels.
    - **Telegram:** HTML tags (`<b>`, `<i>`, `<s>`, `<code>`, `<pre><code>`, `<a href>`).
    - **Signal:** plain text + `text-style` ranges; links become `label (url)` when label differs.
 
+## IR example
+
+Input Markdown:
+
+```markdown
+Hello **world** — see [docs](https://docs.clawd.bot).
+```
+
+IR (schematic):
+
+```json
+{
+  "text": "Hello world — see docs.",
+  "styles": [
+    { "start": 6, "end": 11, "style": "bold" }
+  ],
+  "links": [
+    { "start": 19, "end": 23, "href": "https://docs.clawd.bot" }
+  ]
+}
+```
+
 ## Where it is used
 
 - Slack, Telegram, and Signal outbound adapters render from the IR.