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 参考