之前渲染 Markdown 的時候,筆者使用的是 mavonEditor 的預覽模式,使用起來比較爽,只需要引入元件即可,但是在最近的開發中,遇到了困難.

主要問題在於作為單頁面應用,站內連結必須是使用 router-link 跳轉,如果使用 mavonEditor 預設渲染的 a 標籤,就會重新載入頁面,使用者體驗較差.

動態渲染

想要實現在前端動態地根據使用者內容渲染router-link,需要使用動態渲染,根據 官方文件,直接修改vue.config.js 即可:

// vue.config.js
module.exports = {
 runtimeCompiler: true
}

渲染 Markdown

筆者使用的是 markdown-it,配置過程如下:

安裝

npm install markdown-it --save # 本體
npm install markdown-it-highlightjs --save # 程式碼高亮
npm install markdown-it-katex --save # latex 支援

這裡還另外安裝了兩個語法外掛,如果有其他需要的話,可以在 npm 上搜索

靜態檔案匯入

highlight.js
通過 cdn 匯入,在 index.html 中加入:

<link rel="stylesheet" href="//cdn.jsdelivr.net/gh/highlightjs/[email protected]/build/styles/default.min.css" rel="external nofollow" >
<script src="//cdn.jsdelivr.net/gh/highlightjs/[email protected]/build/highlight.min.js"></script>

github-markdown-css

markdown 的樣式

安裝

npm install github-markdown-css --save

匯入

在 main.js 檔案中新增

import 'github-markdown-css/github-markdown.css'

katex

通過 cdn 匯入,在 index.html 中加入:

<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/KaTeX/0.5.1/katex.min.css" rel="external nofollow" >

使用

首先在 components 目錄下建立 Markdown.vue 檔案,

<template>
 <components :is="html" class="markdown-body"></components>
</template>

<script>
import MarkdownIt from 'markdown-it'
import hljs from 'markdown-it-highlightjs'
import latex from 'markdown-it-katex'
export default {
 name: 'Markdown',props: {
  content: String
 },data: () => ({
  md: null
 }),computed: {
  // 使用 computed 才能在動態繫結時動態更新
  html: function () {
   let res = this.md.render(this.content)
   // 使用正則表示式將站內連結替換為 router-link 標籤
   res = res.replace(/<a href="(?!http:\/\/|https:\/\/)(.*?)" rel="external nofollow" >(.*?)<\/a>/g,'<router-link to="$1">$2</router-link>')
   // 使用正則表示式將站外連結在新視窗中開啟
   res = res.replace(/<a href="(.*?)" rel="external nofollow" >(.*?)<\/a>/g,'<a href="$1" rel="external nofollow" target="_blank">$2</a>')
   return {
    template: '<div>' + res + '</div>'
   }
  }
 },created () {
  this.md = new MarkdownIt()
  this.md.use(hljs).use(latex)
 }
}
</script>

然後在想使用的地方匯入即可

<template>
  <div>
    <Markdown :content="content"/>
  </div>
</template>

<script>
import Markdown from '@/components/Markdown.vue'
export default {
 name: 'Home',components: {
  Markdown
 },data: () => ({
  content: ''
 }),created () {
  this.content = '# 測試'
 }
}
</script>

以上就是Vue單頁面應用中實現Markdown渲染的詳細內容，更多關於vue Markdown渲染的資料請關注我們其它相關文章！