详解基于mpvue的小程序markdown适配解决方案

美团点评近日开源了 mpvue ，这是一个使用 Vue.js 开发小程序的前端框架。使用此框架，开发者将得到完整的 Vue.js 开发体验，同时为 H5 和小程序提供了代码复用的能力。如果想将 H5 项目改造为小程序，或开发小程序后希望将其转换为 H5，mpvue 将是十分契合的一种解决方案。

mpvue 的核心目标是提高开发效率，增强开发体验。使用该框架，开发者只需初步了解小程序开发规范、熟悉 Vue.js 基本语法即可上手。框架提供了完整的 Vue.js 开发体验，开发者编写 Vue.js 代码，mpvue 将其解析转换为小程序并确保其正确运行。此外，框架还通过 vue-cli 工具向开发者提供 quick start 示例代码，开发者只需执行一条简单命令，即可获得可运行的项目。

主要特性：

1. 彻底的组件化开发能力：提高代码
2. 完整的 Vue.js 开发体验
3. 方便的 Vuex 数据管理方案：方便构建复杂应用
4. 快捷的 webpack 构建机制：自定义构建策略、开发阶段 hotReload
5. 支持使用 npm 外部依赖
6. 使用 Vue.js 命令行工具 vue-cli 快速初始化项目
7. H5 代码转换编译成小程序目标代码的能力

实现原理：

Vue代码

1. 将小程序页面编写为 Vue.js 实现
2. 以 Vue.js 开发规范实现父子组件关联

小程序代码

1. 以小程序开发规范编写视图层模板
2. 配置生命周期函数，关联数据更新调用
3. 将 Vue.js 数据映射为小程序数据模型

并在此基础上，附加如下机制

1. Vue.js 实例与小程序 Page 实例建立关联
2. 小程序和 Vue.js 生命周期建立映射关系，能在小程序生命周期中触发 Vue.js 生命周期
3. 小程序事件建立代理机制，在事件代理函数中触发与之对应的 Vue.js 组件事件响应

据悉，mpvue 框架已经在业务项目中得到实践和验证，目前正在美团点评内部大范围使用。mpvue 是基于 Vue.js 源码进行二次开发，在增加了小程序平台的实现同时，保留了跟随 Vue.js 版本升级的能力。

相信开发过小程序的人都知道小程序不支持直接插入dom，那么当我们获取到markdown数据需要渲染的时候就有麻烦。

封装好的 mpvue-wemark 地址

因此github上有很多成熟的小程序markdown渲染方案，但是自己之前写mpvue的时候发现在mpvue上直接用这些库是不行的，因为wxml和vue的写法上是不兼容的，因此就需要对mpvue进行适配。这里我选择wemark这个库。

主要做了几步 ：1、把remarkable.js重新打包成ES版本，mpvue默认脚手架是wepack2不支持es commonjs混用 2、把wxml和小程序js层不兼容vue的写法兼容了下。

demo如下

<template>
 <div>
  <wemark :mdData='mdData'/>
 </div>
</template>

<script>
import wemark from "mpvue-wemark";
export default {
 data() {
  return {
   mdData: ''
  };
 },
 components: {
  wemark
 },
 mounted() {
   this.mdData = "## hello, world";

 }
};
</script>

这样，就实现了在mpvue小程序中渲染出markdown的内容了