更新记录

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 字符的文本仍能保持毫秒级。

九、已知限制

  1. 行内公式 $…$ 不渲染:App 端 text 内不能插入 canvas / 图片节点,行内公式只能按原文显示。块级 $$…$$ 完整支持。
  2. 不支持 HTML 标签:<div>、<br> 等按原文显示(<https://…> 自动链接除外)。
  3. mermaid 支持子集:graph / flowchart 的 LR RL TB TD BT 与常见节点、连线。 sequenceDiagram、classDiagram、gantt 等暂不支持,遇到会自动降级为源码代码块显示,不会报错。
  4. 脚注:仅渲染 [^1]: 说明 定义行,不做正文编号跳转。
  5. 公式/流程图是位图(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 片段。

隐私、权限声明

1. 本插件需要申请的系统权限列表:

无

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

不采集任何数据,不发起任何网络请求

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

无

暂无用户评论。