vue2 使用 markdown插件 v-md-editor

本文介绍了如何在Vue2项目中使用v-md-editor插件,实现Markdown编辑器的功能,包括编辑时的实时预览、代码高亮、文件上传以及编辑内容的回显。详细步骤包括npm安装、全局引入、组件封装和使用,以及解决编辑内容无法回显的问题。同时,还提供了预览组件的使用方法,强调了数据在数据库中需要以HTML格式存储,并给出了Markdown与HTML相互转换的示例代码。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

vue2 使用 markdown插件 v-md-editor

v-md-editor官网

效果

编辑时

在这里插入图片描述

发布后预览

在这里插入图片描述

配置
1、npm安装插件
npm i @kangc/v-md-editor -S
2、main.js 全局引入插件
/* v-md-editor 编辑器 start  */
/* 1、v-md-editor 基础引用  */
import VueMarkdownEditor from '@kangc/v-md-editor';
import '@kangc/v-md-editor/lib/style/base-editor.css';
import vuepressTheme from '@kangc/v-md-editor/lib/theme/vuepress.js';
import '@kangc/v-md-editor/lib/theme/style/vuepress.css';
import Prism from 'prismjs';
VueMarkdownEditor.use(vuepressTheme, {
  Prism,
});

/* 2、v-md-editor 代码块关键字高亮  */
import githubTheme from '@kangc/v-md-editor/lib/theme/github.js';
import '@kangc/v-md-editor/lib/theme/style/github.css';
// 引入所有语言包
import hljs from 'highlight.js';
VueMarkdownEditor.use(githubTheme, {
  Hljs: hljs,
});
Vue.use(VueMarkdownEditor);

/* 3、v-md-editor 二次封装  */
import mdEditor from '@/components/v-md-editor/index';
Vue.component('MdEditor', mdEditor);
/* v-md-editor 编辑器 end  */
3、二次封装插件

1、二次封装
2、main.js 全局引入( 第二部已加入)

在 components 目录下创建 v-md-editor 文件夹并创建文件 index.vue

在这里插入图片描述

index.vue 代码如下

<template>
  <div>
    <v-md-editor 
    v-model="editorValue"
    :disabled-menus="[]"
    @upload-image="handleUploadImage"
    height="calc(100vh - 150px)"></v-md-editor>
  </div>
</template>

<script>
  export default {
    name: 'mdEditor',
    data() {
        return {
            editorValue: this.content != null ? this.content : "",
        }
    },
    props: {
        // 接收值父组件传递值
        content: String
    },
    methods: {
      // v-md-editor 文件上传
      handleUploadImage(event, insertImage, files) {
        // console.log(files);
        // 上传
        for (let i = 0; i < files.length; i++) {
          this.crud.upload(files[i], "image/vMdEditor/").then(res => {
            // 获取返回数据
            let data = res.data.data;
            // 添加图片到内容
            insertImage({
              url: data.url,
              desc: data.name
            });
          });
        }
      },
    },
    watch: {
      editorValue: function (newNum, oldNum) {
        // 修改调用者传入的值
        this.$emit('update:content', newNum)
      }
    },
  }
</script>

<style>
</style>
4、使用

在任意地方使用

 <MdEditor :content.sync="obj.content"></MdEditor>

在这里插入图片描述

5、关于编辑无法回显

初始化 MdEditor 编辑器过早, 可能导致数据无法正常回显
通过 v-if 控制 MdEditor 加载时间 (如下:在调用接口获取数据完成之后修改 initSuccess = true)

以上代码参考的这位朋友,有些地方我做出来修改。

vue2 使用 markdown插件 v-md-editor

以上代码功能,左边markdown右边预览。纯预览功能如下:

1、预览组件
<!-- preview-class 为主题的样式类名,例如vuepress就是vuepress-markdown-body -->
<v-md-preview-html :html="html" preview-class="vuepress-markdown-body"></v-md-preview-html>

data() {
  return {
    html: '',
  };
},
2、全局配置main.js添加如下代码:
import VMdPreviewHtml from '@kangc/v-md-editor/lib/preview-html';
import '@kangc/v-md-editor/lib/style/preview-html.css';

// 引入使用主题的样式
// import '@kangc/v-md-editor/lib/theme/style/vuepress';

Vue.use(VMdPreviewHtml);
注意

组件渲染的是markdown格式的数据,存数据库要存html结构的数据,这个需要做转化。

将html的数据转为markdown的数据格式

1、安装turndown

npm install turndown

2、转换js代码

const TurndownService = require("turndown").default;
var turndownService = new TurndownService();


// this.html为数据库保存的html格式,转换成了markdown格式
var markdown = turndownService.turndown(this.html);
this.content = markdown;

将markdown的数据转为html的数据格式

import VueMarkdownEditor, { xss } from '@kangc/v-md-editor';

// 调用方法将 markdown 转换成 html 并使用 xss 过滤
const html = xss.process(VueMarkdownEditor.themeConfig.markdownParser.render(markdown));
this.html = html;
### 集成 `v-md-editor` 到 Vue 3 项目 为了在 Vue 3 项目中集成 `v-md-editor`,可以遵循以下方法: #### 安装依赖库 首先,在终端执行命令安装必要的包。对于 `v-md-editor` 的集成来说,主要需要安装该编辑器本身以及可能涉及的一些样式文件。 ```bash npm install v-md-editor --save ``` 如果希望使用高亮功能,则还需要额外引入代码高亮的支持工具,比如 `shiki` 或者其他支持的语言语法解析插件[^1]。 ```bash npm i @vueup/vue-quill shiki ``` #### 导入并注册组件 接着,在项目的入口文件或者全局配置的地方导入 `v-md-editor` 并完成初始化设置工作。这通常是在 main.js 文件里完成的操作。 ```javascript import { createApp } from 'vue'; import App from './App.vue'; // Import and register the editor component globally. import VMdEditor from 'v-md-editor'; import 'v-md-editor/lib/style/base-editor.css'; // Base styles. const app = createApp(App); app.use(VMdEditor).mount('#app'); ``` #### 使用自定义主题或扩展能力 除了基本的功能外,还可以通过官方文档了解如何进一步定制化外观、行为等方面的内容来满足特定需求。例如更改默认的主题颜色方案或是添加新的按钮到工具栏上等等[^2]。 #### 实际应用案例展示 最后一步就是按照实际业务逻辑去编写模板部分了。可以在页面中的某个地方放置 `<v-md-editor>` 标签即可快速创建一个富文本区域供用户输入Markdown格式的文字内容。 ```html <template> <div id="editor"> <!-- A simple markdown editor --> <v-md-editor v-model="text"></v-md-editor> </div> </template> <script setup lang="ts"> import { ref } from 'vue'; let text = ref(''); </script> ``` 以上就是在 Vue 3 中成功集成了 `v-md-editor` 后的一个简单例子说明。更多高级特性和详细的参数选项建议查阅官方提供的最新版本指南获取更多信息。
评论 3
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值