[Q&A] 钉钉适配器发送消息时，为什么需要两个 \n 才能换行？

[k1ngr4m]

What happened / 发生了什么

钉钉适配器中，如果yield event.plain_result(msg)中的msg只有一个换行符\n，那么在钉钉收到的消息中没有换航
需要输入\n\n才能换行。

Reproduce / 如何复现？

        msg = f"📜 【角色详情：{character.name_zh}】\n"
        msg += f"简介：{character.description}\n"
        yield event.plain_result(msg)

        msg = f"📜 【角色详情：{character.name_zh}】\n\n"
        msg += f"简介：{character.description}\n\n"
        yield event.plain_result(msg)

AstrBot version, deployment method (e.g., Windows Docker Desktop deployment), provider used, and messaging platform used. / AstrBot 版本、部署方式（如 Windows Docker Desktop 部署）、使用的提供商、使用的消息平台适配器

astrbot: v4.10.2

OS

macOS

Logs / 报错日志

无报错

Are you willing to submit a PR? / 你愿意提交 PR 吗？

• Yes!

Code of Conduct

• I have read and agree to abide by the project's Code of Conduct。

[dosubot[bot]]

钉钉适配器需要两个 \n 才能换行，是因为 AstrBot 发送消息时用的是钉钉的 markdown 格式接口（client.reply_markdown），而在 Markdown 语法里，单个换行符不会显示为换行，只有两个换行（\n\n）或插入 <br/> 才能产生可见的段落分隔或换行效果。这不是 AstrBot 的 bug，而是钉钉平台对 Markdown 渲染的标准行为，AstrBot 只是原样传递文本，没有做特殊处理。相关代码实现

建议：如果需要换行，直接用 \n\n 或 <br/>。这个行为目前没有在 AstrBot 文档里明确说明，后续可以考虑补充到 FAQ 或文档里，方便新用户快速了解。

To reply, just mention @dosu.

---

Share context across your team and agents. Try Dosu.

[anka-afk]

这个问题是钉钉 Markdown 接口的渲染行为，并不是 AstrBot 本身的 Bug。

AstrBot 的钉钉适配器使用 client.reply_markdown 发送消息，单个 \n 通常不会被渲染成可见的换行。

如果需要换行，可以使用：

• \n\n：分隔段落
• <br/>：插入换行

例如：

msg = "第一行\n\n第二行"
yield event.plain_result(msg)

相关实现：[dingtalk_event.py](

AstrBot/astrbot/core/platform/sources/dingtalk/dingtalk_event.py

Lines 23 to 75 in 350667b

	async def send_with_client(
	self,
	client: dingtalk_stream.ChatbotHandler,
	message: MessageChain,
	):
	icm = cast(dingtalk_stream.ChatbotMessage, self.message_obj.raw_message)
	ats = []
	# fixes: #4218
	# 钉钉 at 机器人需要使用 sender_staff_id 而不是 sender_id
	for i in message.chain:
	if isinstance(i, Comp.At):
	print(i.qq, icm.sender_id, icm.sender_staff_id)
	if str(i.qq) in str(icm.sender_id or ""):
	# 适配器会将开头的 $:LWCP_v1:$ 去掉，因此我们用 in 判断
	ats.append(f"@{icm.sender_staff_id}")
	else:
	ats.append(f"@{i.qq}")
	at_str = " ".join(ats)
	for segment in message.chain:
	if isinstance(segment, Comp.Plain):
	segment.text = segment.text.strip()
	await asyncio.get_event_loop().run_in_executor(
	None,
	client.reply_markdown,
	segment.text,
	f"{at_str} {segment.text}".strip(),
	cast(dingtalk_stream.ChatbotMessage, self.message_obj.raw_message),
	)
	elif isinstance(segment, Comp.Image):
	markdown_str = ""
	try:
	if not segment.file:
	logger.warning("钉钉图片 segment 缺少 file 字段，跳过")
	continue
	if segment.file.startswith(("http://", "https://")):
	image_url = segment.file
	else:
	image_url = await segment.register_to_file_service()
	markdown_str = f"\n\n"
	ret = await asyncio.get_event_loop().run_in_executor(
	None,
	client.reply_markdown,
	"😄",
	markdown_str,
	cast(
	dingtalk_stream.ChatbotMessage, self.message_obj.raw_message
	),
	)
	logger.debug(f"send image: {ret}")

)

目前已有可行的解决方法，这里标记为已解决，留作参考。如果还有其他问题，欢迎继续讨论。