swiftstreamingmarkdown

为iOS/macOS应用提供流畅的Markdown流式渲染库。

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:swiftstreamingmarkdown。
它的用途是:为iOS/macOS应用提供流畅的Markdown流式渲染库。
完整的 Skill 内容见:https://321skill.com/skills/swiftstreamingmarkdown/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

“我正在开发一个iOS端的AI对话应用,需要将模型返回的Markdown格式回答流畅地展示给用户。”,它会推荐你集成 SwiftStreamingMarkdown,并展示如何配置流式视图和自定义主题。接着,你可以让AI帮你生成集成该库的示例代码片段,并解释如何处理分块到达的文本数据。

介绍

SwiftStreamingMarkdown 是一个由微软开源的 Swift 库,专门用于在 iOS 和 macOS 应用中渲染 Markdown 内容。它核心解决了在接收大型语言模型(LLM)等场景下,Markdown 文本分块、实时到达时的流畅渲染问题,避免了界面卡顿和内容跳动。

使用上,开发者可以通过 Swift Package Manager 轻松集成,并利用其提供的 SwiftUI 视图组件快速构建支持流式渲染的界面。库内建了对 LaTeX 数学公式、引用标注、代码高亮等复杂元素的支持,并能通过主题配置进行深度定制。

它非常适合需要集成 AI 对话、实时日志显示、或任何需要优雅展示渐进式 Markdown 文本的苹果平台开发者。无论是构建 AI 助手应用、技术文档阅读器,还是支持 Markdown 的笔记应用,都能从中受益。

需要注意的是,该库专注于渲染,本身不包含网络请求或文本解析功能,需要开发者自行处理数据流。此外,其图像渲染功能需要显式配置允许列表以确保安全。

核心特点

核心优势在于专为“流式”场景优化,能在新文本块到达时实现平滑的视觉过渡,而非整个文档重新渲染,这在显示 AI 逐字生成回复时体验极佳。同时,它原生支持 LaTeX 数学公式和引用标注,这在同类渲染库中较为少见。

注意事项

不适合需要渲染完整 CommonMark 规范(如脚注、定义列表)或非苹果平台(如 Web、Android)的项目。

常见问题

SwiftStreamingMarkdown 支持图片渲染吗?

支持,但需通过实验性的 ImageConfig 显式配置图片来源(如远程URL白名单、资源目录),并内置了全屏查看器。

它能用于 watchOS 或 tvOS 吗?

目前官方仅支持 iOS 16+ 和 macOS 14+,未提及对其他苹果平台的支持。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/swiftstreamingmarkdown/raw/index.md 读取 swiftstreamingmarkdown 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。