From 1aa7cb95d6a322e2f58167021836cde06e914189 Mon Sep 17 00:00:00 2001
From: Scofy0123 <260077525+Scofy0123@users.noreply.github.com>
Date: Mon, 6 Apr 2026 18:39:45 +0800
Subject: [PATCH] docs(im): Document critical Feishu Markdown silent drop
 limitations

- Add warning against using non-HTTP(S) schemas in Markdown links which triggers silent client drops.
- Add warning against nesting links inside bold tags (`**[title](url)**`), which strips the link completely in the native Feishu Post renderer.
---
 skills/lark-im/references/lark-im-messages-send.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/skills/lark-im/references/lark-im-messages-send.md b/skills/lark-im/references/lark-im-messages-send.md
index d9a57816..5c8beb33 100644
--- a/skills/lark-im/references/lark-im-messages-send.md
+++ b/skills/lark-im/references/lark-im-messages-send.md
@@ -57,6 +57,9 @@ This means `--markdown` is convenient, but it is not a full-fidelity Markdown tr
 - It does **not** promise full CommonMark / GitHub Flavored Markdown support.
 - It always becomes a `post` payload with a single `zh_cn` locale.
 - It does **not** let you set a `post` title. If you need a title, use `--msg-type post --content ...`.
+- **Link parsing restrictions (Critical for silent drops):**
+    - Non-HTTP(S) URL schemes (e.g. `[query](from:user)`) are strictly forbidden and will cause the link (or sometimes the whole paragraph) to be silently dropped by the Feishu client.
+    - **No bold nested links**: Feishu's Markdown parser will silently destroy links if they are wrapped inside bold tags. Never write `**[Title](https://...)**`. Instead, place them outside like `**Item.** [Title](https://...)`.
 - Headings are rewritten:
     - `# Title` becomes `#### Title`
     - `##` to `######` are normalized to `#####` when the content contains H1-H3