更新记录
1.0.0(2026-11-20)
首个版本。
渲染能力
- 标题 1~6 级、段落、软换行
- 行内:粗体 / 斜体 / 粗斜体 / 删除线 / 行内代码 / 链接 / 自动链接 / 裸链接 / 裸邮箱
- 有序、无序列表任意嵌套;任务列表(
- [x]/- [ ]) - 表格:列对齐、单元格内行内语法、列多时横向滚动
- 块引用:嵌套与懒延续行
- 分割线:按标记字符区分线型(星号点线 / 下划线双线 / 其余渐隐实线)
- 代码块:语言标签、右上角复制、横向滚动
- 图片:宽度自适应、点击全屏预览、加载失败占位卡片(可复制地址)
- 脚注定义行
- 块级公式
…:分数、上下标、根号、希腊字母、大运算符、\left\right自适应括号、矩阵、aligned - mermaid 流程图:
graph/flowchart的LR RL TB TD BT,常见节点形状与连线(不支持的类型自动降级为源码)
工程特性
- 零第三方依赖、零网络请求、无静态资源
- 解析结果为扁平
MdRow[],渲染侧不递归,流式追加不闪烁 - 深浅色由
MdPalette计算成内联样式,theme切换实时生效(不使用 CSS 变量与祖先选择器) accentColor支持一键换品牌主色,淡背景/引用色/链接色自动派生- canvas 不可用时自动降级为源码显示,不白屏
- 同一页面可放多个实例(canvas id 按实例前缀隔离)
- 对外导出解析器与调色板,可从
@/uni_modules/everyble-md-view导入
平台兼容性
uni-app(3.8.12)
| Vue2 | Vue3 | Chrome | Safari | app-vue | app-nvue | Android | iOS | 鸿蒙 |
|---|---|---|---|---|---|---|---|---|
| - | - | - | - | - | - | - | - | - |
| 微信小程序 | 支付宝小程序 | 抖音小程序 | 百度小程序 | 快手小程序 | 京东小程序 | 鸿蒙元服务 | QQ小程序 | 飞书小程序 | 小红书小程序 | 快应用-华为 | 快应用-联盟 |
|---|---|---|---|---|---|---|---|---|---|---|---|
| - | - | - | - | - | - | - | - | - | - | - | - |
uni-app x(3.8.12)
| Chrome | Safari | Android | iOS | 鸿蒙 | 微信小程序 |
|---|---|---|---|---|---|
| - | - | √ | √ | √ | - |
其他
| 多语言 | 暗黑模式 | 宽屏模式 | 蒸汽模式 |
|---|---|---|---|
| √ | √ | √ | × |
everyble-md-view · uni-app x Markdown 渲染引擎(纯 UTS)
一个只用 UTS 写的 uni-app x Markdown 组件:不依赖 npm、不依赖原生插件、不发任何网络请求,
<everyble-md-view :markdown="text" /> 一行就能把 AI 回答渲染成带样式的富文本。
除了常规语法,它还内置了两件「通常要再装两个库」的能力:
$$ … $$LaTeX 公式 —— 自己排版、自己用 canvas 画(分数、根号、上下标、求和积分、矩阵、\left\right自适应括号)```mermaid流程图 —— 自己布局、自己用 canvas 画(LR/RL/TB/BT、菱形/圆角/圆柱/六边形节点、虚线/箭头/连线文字)
两者都不需要 WebView、不需要 mathjax、不需要 mermaid.js,离线可用、渲染不进 DOM、长列表不卡。
一、为什么用它
| 本插件 | uni-cmark 类插件 | WebView + marked/mermaid | |
|---|---|---|---|
| 依赖 | 无 | 部分需原生插件 | 需 WebView + JS 库 |
| 公式 | 内置 canvas 自绘 | 不支持 | 需 mathjax(重) |
| 流程图 | 内置 canvas 自绘 | 不支持 | 需 mermaid.js(很重) |
| 深色模式 | 内联调色板,切换实时生效 | 需自己写一堆覆盖样式 | 需重载网页 |
| 流式追加 | 支持(解析结果扁平化,无 DOM 复用问题) | 支持 | 易闪烁 |
| 体积 | 约 4000 行 UTS,无静态资源 | 视实现 | 数 MB |
二、支持的语法
- 标题 1~6 级(
#~######,自动去掉尾部#) - 段落、软换行、
**粗体**、*斜体*、~~删除线~~、***粗斜体***、`行内代码` - 无序列表(
-*+)、有序列表(1.1),任意嵌套(缩进层级自动计算) - 任务列表
- [x]/- [ ] - 表格:列对齐(
:---:---:---:)、列多时自动横向滚动、单元格内支持行内语法 - 块引用
>(支持嵌套、支持懒延续行) - 分割线
---***___(以及— ─ ━ ═ =等中文排版划线),按标记字符渲染不同线型: 星号 → 点线、下划线 → 双线、其余 → 两端渐隐实线 - 代码块(围栏式),右上角「复制」,超宽自动横向滚动
- 图片:宽度自适应、点击全屏预览、加载失败显示占位卡片(可复制地址)
- 链接:
[文字](url)、自动链接<https://…>、裸链接https://…、裸邮箱 - 脚注定义行
[^1]: 说明 - 块级公式
$$ … $$(单行与多行) - mermaid 流程图代码块
三、平台兼容
| 平台 | 支持 | 说明 |
|---|---|---|
| App-Android | ✅ | HBuilderX 4.19+,标准基座或自定义基座 |
| App-iOS | ✅ | 同上 |
| App-Harmony | ✅ | HBuilderX 4.81+ |
| Web / 小程序 | 未测试 | 表格、代码块、列表可用;canvas 能力依平台而定,不可用时自动降级为源码显示 |
公式与流程图依赖
uni.createCanvasContextAsync+CanvasRenderingContext2D。 如果运行环境里没有 canvas 原生模块(典型:用旧的自定义基座跑新代码),组件会自动降级为源码文本, 不会白屏、不会刷一屏报错。
四、安装
把 everyble-md-view 目录放进工程的 uni_modules 下即可(插件市场一键导入,或手动拷贝)。
无需 npm install,无需改 App.uvue,也无需在 pages.json 里注册组件 —— 组件符合 easycom 规范,直接用标签。
五、快速开始
<template>
<scroll-view direction="vertical">
<everyble-md-view :markdown="answer" :theme="isDark ? 'dark' : 'light'" />
</scroll-view>
</template>
<script setup lang="uts">
const answer = ref('# 你好\n\n这里是 **Markdown**。')
const isDark = ref(false)
</script>
markdown 变化即重新渲染,流式输出时直接改这个值:
onChunk((delta: string) => {
answer.value = answer.value + delta
})
六、API
属性
| 属性 | 类型 | 默认值 | 说明 |
|---|---|---|---|
markdown |
String | '' |
Markdown 原文 |
theme |
String | 'auto' |
'auto' 跟随系统 / 'light' 强制浅色 / 'dark' 强制深色 |
accentColor |
String | '' |
主色,'#rrggbb'。留空用内置紫;填了会自动派生淡背景、引用色、链接色 |
fontSize |
Number | 15 |
正文字号(px),标题按级别自动放大 |
lineHeight |
Number | 23 |
正文行高(px) |
availableWidth |
Number | 0 |
组件可用宽度(px)。0 表示按屏宽减 contentInset 估算 |
contentInset |
Number | 32 |
估算宽度时扣除的左右留白(组件在气泡/卡片里时用它对齐) |
previewImage |
Boolean | true |
点击图片是否调用 uni.previewImage 全屏预览 |
showCodeCopy |
Boolean | true |
代码块右上角是否显示「复制」 |
表格和公式画布的宽度是按
availableWidth(或 屏宽 -contentInset)算的。 放在聊天气泡里时,把contentInset设成气泡左右 padding 之和,表格右边就不会被裁掉。
事件
| 事件 | 参数 | 说明 |
|---|---|---|
linktap |
url: String |
点击了行内链接(插件不自己跳转,交给宿主决定用 navigateTo 还是 openURL) |
imagetap |
url: String |
点击了图片(previewImage 为 true 时插件已做预览,这里只做通知) |
codecopy |
text: String |
点击了代码块「复制」 |
horizontaltouch |
— | 手指落在表格 / 代码块 / 公式等横向滚动区域。页面若有「左滑拉出侧栏」这类全局手势,收到后应让位 |
主题
<!-- 跟随系统(默认,仅适合没有自己主题体系的 App) -->
<everyble-md-view :markdown="md" />
<!-- 推荐:跟随宿主 App 自己的主题开关 -->
<everyble-md-view :markdown="md" :theme="isDark ? 'dark' : 'light'" />
<!-- 换品牌主色 -->
<everyble-md-view :markdown="md" accent-color="#2f7cf6" />
插件内部不使用 CSS 变量、不用 .dark 祖先选择器:所有颜色都由调色板计算成内联样式,
所以 theme 一变整块内容立即换色,不需要刷新页面,也不会残留深色块
(uni-app x App 端祖先 class 变化不会重算后代样式,这个坑已经绕开)。
theme="auto"不要和宿主自己的主题开关混用。 插件的auto是读系统osTheme并监听onAppThemeChange/onOsThemeChange, 它并不知道宿主是否把外观手动锁成了浅色或深色。如果宿主有「跟随系统 / 浅色 / 深色」 三态设置(手动模式会覆盖系统),请由宿主算出isDark后传明确的'light'/'dark', 否则会出现「宿主设浅色、插件按系统深色渲染」的不一致;宿主调用uni.setAppTheme()还会触发插件的全局主题回调,表现会随注册顺序漂移。
七、单独使用解析器
不需要渲染组件、只要 AST 时(例如做搜索高亮、导出文本、自定义排版):
import { parseMarkdownRows, MdRow, MdSpan } from '@/uni_modules/everyble-md-view'
const rows: MdRow[] = parseMarkdownRows(md)
for (let i = 0; i < rows.length; i++) {
const r = rows[i]
// r.kind: heading | para | code | table | li | hr | math | footnote
// r.spans: 行内片段(bold/italic/code/strike/link)
}
解析结果是扁平数组(不是树):嵌套列表用 depth 表达层级、引用用 quote 表达层级,
渲染侧不需要递归,流式输出时也不需要维护节点树。
可用的导出:
| 导出 | 说明 |
|---|---|
parseMarkdownRows(md) |
解析为 MdRow[] |
parseInline(src, images) |
只解析行内语法为 MdSpan[],图片收集到 images |
mdPalette(dark, accent) |
取调色板 MdPalette,宿主自绘配套 UI 时可复用同一套色 |
mdHexToRgba(hex, alpha) |
十六进制转 rgba 字符串 |
mdSystem / mdSystemThemeInit() |
系统深色状态(mdSystem.isDark)与监听初始化 |
MD_VIEW_VERSION |
插件版本号 |
八、性能
以 4KB、含公式与流程图的真实 AI 回答为例(中端 Android 真机):
| 环节 | 耗时 |
|---|---|
| 解析(全量) | 约 1.5 ms |
| 行内嗅探(判断是否 markdown) | 约 0.03 ms |
| 公式首次排版+绘制 | 约 5 ms |
| 流程图首次布局+绘制 | 约 8 ms |
| 主题切换(整块换色) | 约 1 帧 |
解析器不使用有回溯风险的正则,全部是单次扫描的字符级解析;超过 8000 字符的文本仍能保持毫秒级。
九、已知限制
- 行内公式
$…$不渲染:App 端text内不能插入 canvas / 图片节点,行内公式只能按原文显示。块级$$…$$完整支持。 - 不支持 HTML 标签:
<div>、<br>等按原文显示(<https://…>自动链接除外)。 - mermaid 支持子集:
graph/flowchart的LR RL TB TD BT与常见节点、连线。sequenceDiagram、classDiagram、gantt等暂不支持,遇到会自动降级为源码代码块显示,不会报错。 - 脚注:仅渲染
[^1]: 说明定义行,不做正文编号跳转。 - 公式/流程图是位图(canvas),不参与文字选择与复制;代码块与正文可以正常复制。
十、常见问题
Q:公式/流程图显示的是一堆源码? A:两种情况 —— ① 基座里没有 canvas 原生模块(用 HBuilderX 标准基座重新运行,或重新制作自定义基座); ② 语法超出了支持的子集(此时按源码显示是预期行为)。
Q:切换深色后没变化?
A:请改 theme 属性,而不是给外层容器加 class。插件不读任何全局 class。
Q:表格右边被裁掉/出现横向滚动条?
A:调 contentInset(气泡左右 padding 之和)或直接传 availableWidth。
Q:点击链接没反应?
A:监听 linktap 自己处理跳转,插件只负责抛出 URL(不同 App 对 openURL 的白名单策略不同,交给宿主更稳)。
Q:能和「左滑拉出侧栏」的手势共存吗?
A:监听 horizontaltouch,在这个事件里给页面手势打一个「让位」标记即可(参考 demo 集成页)。
十一、授权
- 购买后可用于任意数量的商业项目,绑定购买时的 DCloud appid 与包名。
- 未经授权不得二次分发、转售、公开源码;源码授权版可自行修改,但同样不得再分发。
- 组件不采集任何数据、不发起任何网络请求,无广告、无系统权限。
更新记录见 changelog.md。问题反馈请通过插件市场「问题反馈」提交,附 HBuilderX 版本、平台、可复现的最小 markdown 片段。

收藏人数:
购买源码授权版(
试用
赞赏(0)
下载 0
赞赏 0
下载 12778170
赞赏 1960
赞赏
京公网安备:11010802035340号