mp-html是uni-app三端统一渲染Markdown最稳妥方案,通过解析HTML为原生组件树实现表格、代码块等完整支持,避免v-html在小程序中的白屏与乱码问题。

mp-html 是当前 uni-app 项目中渲染 Markdown 最稳妥、开箱即用的选择,尤其适合 H5 + 微信小程序 + App 三端统一场景。它不是“把 Markdown 转成 HTML 再 v-html”,而是把 HTML 字符串解析为原生组件树(rich-text + 自定义节点),能真正渲染表格、代码块、标题层级等——而直接用 v-html 在小程序里基本是白屏或乱码。
为什么不能直接用 marked + v-html?
小程序的 安装命令必须用 Vue 3 兼容版: 在页面中直接使用(无需全局注册): 当你需要数学公式(LaTeX)、流程图(Mermaid)、自动生成目录(TOC)、或重度技术文档时, 使用 SQLite FTS5 对结构化 Markdown 文档库进行全文搜索,适用于需要快速、高效搜索大量 Markdown 文章的场景。 从 GitHub API 或后端读取的 Markdown 常含相对路径图片或 base64 图片, 最常被忽略的一点:无论选 rich-text 组件对 HTML 标签支持极弱:、
、、带 class 的标签全被过滤;v-html 在非 H5 端根本不可用。你看到的“乱码”其实是未被识别的原始符号(比如 ### 标题 直接显示为文字)。更关键的是,v-html 无法触发点击复制代码、图片预览、TOC 跳转等交互。mp-html 安装与基础用法(Vue 3 项目)
npm install mp-html@latest
js\nconsole.log("uni-app")\n
mp-html 只接收已转好的 HTML 字符串,不内置 Markdown 解析器,所以得自己用 marked 或 markdown-it 预处理highlight.js 并传给 marked,否则代码块只是纯文本mp-html 默认禁用内联样式,如需自定义颜色/字体,得通过 styles prop 或全局 CSS 类覆盖towxml 适合什么场景?
towxml 更合适。但它有硬性约束:
wxcomponents/towxml 目录下,路径写错就加载失败pages.json 的 usingComponents 中显式声明,且只对当前页面生效main.js(Vue 2)或 main.ts(Vue 3 SSR)里挂载到 app.config.globalProperties,漏掉这步会报 this.$towxml is not a function
nodes),不是 HTML 字符串,要传给 容易踩的坑:图片和 base64 处理
mp-html 默认不处理这些:
)会 404,需在 marked 渲染前用正则替换为绝对路径或 CDN 地址)在小程序里可能被拦截,得用 uni.downloadFile 临时保存再转本地路径,或改用 mp-html 的 customNode hook 拦截 img 标签并重写 src
mp-html 的 lazyLoad 属性 + image slot 自定义加载占位mp-html 还是 towxml,都不要在 onLoad 里直接解析长 Markdown —— 同步解析 >10KB 文本会导致小程序主线程卡死。务必用 setTimeout 或 nextTick 延迟渲染,或分片处理。










