Swift Markdown Kit · DOCS
概览
Swift Markdown Kit
面向 iOS 的商业 Markdown 渲染 SDK,交付形态是 SwiftMarkdownKit.xcframework。
它是为 LLM 输出做的。流式 token、整段会话渲染、推理折叠都是一等能力,不是后加的。
六行接入一个会话
import SwiftUI
import SwiftMarkdownKit
struct ConversationView: View {
let messages: [MarkdownChatMessage]
var body: some View {
MarkdownChatRenderView(messages: messages)
}
}
这就是一个完整可用的接入。不写任何配置,你已经拥有:
- Markdown、表格、代码高亮、KaTeX 公式、任务列表。
- 流畅的流式渲染,整条回答的总渲染成本是 O(n)。
<think>推理内容折叠成正文上方的面板。- 链接在应用内浏览器打开,图片全屏预览。
- 代码块和消息的复制按钮。
- 深浅色、Dynamic Type,以及对半截 Markdown 的容错。
这份文档后面的内容,都是关于「你想改哪一块」。
环境要求
- iOS 17.0 及以上
- macOS 通过 Mac Catalyst 支持 —— 用的是同一套实现,公式、表格和流式回答在两端 渲染结果一致。请选 My Mac (Mac Catalyst) 目标;My Mac 是原生 macOS, 没有 UIKit 也没有可链接的切片。原生 AppKit target 不在支持范围内。
- Xcode 16 及以上
- 一份按你的 Apple Team ID 或 bundle identifier 签发的
.smklicense
先评估,再付款
SDK 从不因为没有授权而隐藏任何功能。没有授权时,每一项能力的渲染结果和上线后
完全一致,只是右下角会带一个 Unlicensed · macdeer.com 角标,并在控制台
打印一行说明原因。
也就是说,你可以先接进工程、渲染真实内容、量真实的滚动性能、跑通 CI,全部完成 之后再决定是否付款。试用与正式授权的区别见 授权。
接下来看哪一页
| 你想做的事 | 去看 |
|---|---|
| 把 SDK 装进工程 | 安装 |
| 渲染一段 LLM 会话 | 流式与会话 |
| 渲染一篇文档或文章 | 单文档渲染 |
| 决定链接、图片点击归谁处理 | 点击交互 |
| 让它符合 App 的设计 | 主题与语法 |
| 查某个类型、事件或错误码 | API 参考 |