X Markdown

📦 包职责边界

⚠️ x-markdown 不是聊天状态管理工具。它负责把已有消息内容渲染出来，不负责请求和消息流本身。

🚀 快速决策指南

🛠 推荐工作流

1. 先看 CORE.md，先让基础渲染跑通。
2. 只有在内容是分块到达时，才继续看 STREAMING.md。
3. 只有在需要自定义标签、插件、主题时，才继续看 EXTENSIONS.md。
4. 属性名与默认值以 API.md 为准，不要凭记忆猜。

最小使用示例

import { XMarkdown } from '@ant-design/x-markdown';

export default () => <XMarkdown content="# Hello" />;

🚨 开发规则

• components 映射尽量保持稳定，不要在每次渲染时创建新的内联组件对象。
• 最后一块内容必须设置 streaming.hasNextChunk = false，否则不完整占位内容不会被刷新成最终结果。
• 谨慎处理原始 HTML。如果只想保留文本展示，优先使用 escapeRawHtml。
• 如果必须渲染 HTML，请显式审查 dompurifyConfig，不要依赖模糊默认行为。
• 主题覆盖尽量最小化。先继承 x-markdown-light 或 x-markdown-dark，只改必要变量。
• 如果自定义组件依赖完整语法，再在 streamStatus === 'done' 时执行昂贵逻辑。

🤝 技能协作

边界规则

• 适配接口格式，用 x-chat-provider
• 配置传输、认证、重试、流分隔，用 x-request
• 管理 React 聊天状态，用 use-x-chat
• 处理 Markdown 解析、流式恢复和富组件渲染，用 x-markdown

🔗 参考资源

• CORE.md - 包职责、安装与起步、安全默认值、常见渲染模式
• STREAMING.md - 分块渲染、不完整语法恢复、loading/done 行为
• EXTENSIONS.md - 组件映射、插件、主题、自定义标签建议
• API.md - 从官方 x-markdown 文档生成的 API 参考

官方文档

• XMarkdown 介绍
• XMarkdown 示例
• XMarkdown 流式渲染
• XMarkdown Components
• XMarkdown 插件
• XMarkdown 主题