前端解析markdown处理代码块高亮并添加复制功能实例代码

 更新时间:2025年11月12日 09:42:53   作者:yuan溜溜  
在Markdown中,原生语法并不直接支持文字高亮,不过你可以通过一些扩展的Markdown语法或者HTML标签来实现,这一效果这篇文章主要介绍了前端解析markdown处理代码块高亮并添加复制功能的相关资料,需要的朋友可以参考下

一、Marked.js简介与基本使用

Marked.js是一个轻量级的Markdown解析器,可以将Markdown文本快速转换为HTML。它易于使用且高度可定制。

基本使用方法

首先,安装引入Marked.js库:

npm i marked.js
import { Marked } from 'marked'

然后,使用简单的API进行转换:

// 解析Markdown文本
const markdownText = '# 标题\n\n这是一段**加粗**的文本。';
const htmlContent = marked.parse(markdownText);

二、实现代码语法高亮

虽然Marked.js可以解析代码块,但它本身不提供语法高亮功能。我们需要结合marked-highlight和Highlight.js来实现这一功能。

1. 引入Highlight.js和marked-highlight

marked-highlight是一个专门为Marked.js设计的扩展包,它需要配合highlight.js才能实现代码高亮功能。marked-highlight本身并不包含高亮逻辑,它只是提供了一个桥梁,让Marked.js能够方便地使用Highlight.js。

import { markedHighlight } from 'marked-highlight'
import hljs from 'highlight.js'
import 'highlight.js/styles/github-dark.css'

2. 配置Marked.js使用Highlight.js和markedHighlight

// 配置Marked.js
const marked = new Marked(
  markedHighlight({
    async: false, // 如果是异步的,可以设置为 true
    langPrefix: 'language-', // 可选:用于给代码块添加前缀
    highlight: code => {
      return hljs.highlightAuto(code).value
    },
  })
)

配置完成之后使用

<div v-html="markdown"></div>
const markdown = computed(() => marked.parse(mdStr))

效果如下:

三、获取语言类型以及添加代码复制功能

// 复制逻辑
const copyToClipboard = codeBlock => {
  const answer = codeBlock.textContent.trim()
  if (navigator.clipboard && navigator.clipboard.writeText) {
    return navigator.clipboard
      .writeText(answer)
      .then(() => {
        showSuccessToast('复制成功')
      })
  }
}
// 获取语言类型
const getLanguageCode = codeBlock => {
  const classList = codeBlock.className.split(' ')
  const langClass = classList.find(class => class.startsWith('language-'))
  if (langClass) {
    return langClass.replace('language-', '')
  }
  const parentClassList = codeBlock.parentNode.className.split(' ')
  const preLangClass = parentClassList.find(class => class.startsWith('language-'))
  if (preLangClass) {
    return preLangClass.replace('language-', '')
  }

  return null
}
// 添加复制按钮功能
const addCopyBtns = () => {
  nextTick(() => {
    const codeBlocks = document.querySelectorAll('pre code')
    codeBlocks.forEach(block => {
      if (block.parentNode.querySelector('.code-box')) {
        return
      }

      const parent = block.parentNode
      const codeBoxEle = document.createElement('div')
      codeBoxEle.className = 'code-box'
      const language = getLanguageCode(block)
      const langEle = document.createElement('span')
      langEle.className = 'code-lang'
      langEle.textContent = language || 'code'
      const copyButtonEle = document.createElement('div')
      copyButtonEle.className = 'copy-button'
      copyButtonEle.innerHTML = '复制'
      copyButtonEle.onclick = () => copyToClipboard(block)
      codeBoxEle.appendChild(langEle)
      codeBoxEle.appendChild(copyButtonEle)
      parent.classList.add('code-box')
      parent.appendChild(codeBoxEle)
    })
  })
}

ve3项目中使用(因为是流式输出,所以需要监听返回内容)

watch(markdown, newValue => {
  if (newValue) {
    nextTick(() => {
      addCopyBtns()
    })
  }
})
onMounted(() => {
  addCopyBtns()
})

效果如下

四、总结

Marked.js本身是一个纯JavaScript编写的Markdown解析器,因此它没有语言限制——它可以在任何支持JavaScript的环境中运行,通过结合Marked.js和Highlight.js,我们可以轻松实现Markdown文档的解析和代码高亮功能。添加复制按钮进一步提升了用户体验,让用户可以方便地获取代码片段。

对于react或者vue项目也可以使用其相应的开源方案,使用更加简洁,比如(需要的可以自行去了解)

Vue生态系统

  1. vue-markdown - 基于Marked.js的Vue组件
  2. @vuepress/markdown - VuePress使用的Markdown处理器
  3. vue-highlightjs - Vue的代码高亮指令
  4. element-plus - 提供ElCode组件用于代码展示

React生态系统

  1. react-markdown - 最流行的React Markdown渲染器
  2. react-syntax-highlighter - 功能强大的代码高亮组件
  3. highlight.js - 通用的代码高亮库
  4. @uiw/react-md-editor - 带编辑功能的Markdown组件

到此这篇关于前端解析markdown处理代码块高亮并添加复制功能的文章就介绍到这了,更多相关前端解析markdown代码块高亮内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • JavaScript实现的多种鼠标拖放效果

    JavaScript实现的多种鼠标拖放效果

    这篇文章主要介绍了JavaScript实现的多种鼠标拖放效果,涉及JavaScript响应鼠标事件动态变换页面元素属性的相关技巧,具有一定参考借鉴价值,需要的朋友可以参考下
    2015-11-11
  • 前端JS如何创建一个可随时取消的定时器

    前端JS如何创建一个可随时取消的定时器

    这篇文章主要为大家详细介绍了前端JavaScript如何创建一个可随时取消的定时器,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下
    2025-08-08
  • 利用canvas中toDataURL()将图片转为dataURL(base64)的方法详解

    利用canvas中toDataURL()将图片转为dataURL(base64)的方法详解

    这篇文章主要给大家介绍了关于利用canvas中toDataURL()将图片转为dataURL(base64)的相关资料,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧。
    2017-11-11
  • 详解ES6数组方法find()、findIndex()的总结

    详解ES6数组方法find()、findIndex()的总结

    这篇文章主要介绍了详解ES6数组方法find()、findIndex()的总结,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2020-05-05
  • JavaScript 空间坐标的使用

    JavaScript 空间坐标的使用

    这篇文章主要介绍了JavaScript 空间坐标的使用,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2020-08-08
  • JavaScript实现类继承的方法最全讲解

    JavaScript实现类继承的方法最全讲解

    JavaScript 类继承通过extends和super关键字提供了一种直观的面向对象编程方式,基于原型链实现,这篇文章主要介绍了JavaScript实现类继承的相关资料,文中通过代码介绍的非常详细,需要的朋友可以参考下
    2025-09-09
  • Express与NodeJs创建服务器的两种方法

    Express与NodeJs创建服务器的两种方法

    本文主要介绍了NodeJs创建Web服务器;Express创建Web服务器的两种方法,具有一定的参考价值,下面跟着小编一起来看下吧
    2017-02-02
  • JavaScript中的值是按值传递还是按引用传递问题探讨

    JavaScript中的值是按值传递还是按引用传递问题探讨

    这篇文章主要介绍了JavaScript中的值是按值传递还是按引用传递问题探讨,本文讲解了按值传递、按引用传递、按共享传递、基本类型的不可变(immutable)性质等内容,需要的朋友可以参考下
    2015-01-01
  • 全面解析JavaScript Module模式

    全面解析JavaScript Module模式

    这篇文章主要介绍了JavaScript Module模式的相关资料,文中讲解非常细致,代码帮助大家更好的理解和学习,感兴趣的朋友可以了解下
    2020-07-07
  • JavaScript的设计模式经典之建造者模式

    JavaScript的设计模式经典之建造者模式

    建造者模式是设计模式的一种,将一个复杂对象的构建与它的表示分离,使得同样的构建过程可以创建不同的表示。接下来通过本文给大家介绍JavaScript的设计模式经典之建造者模式,感兴趣的朋友一起学习吧
    2016-02-02

最新评论