Migration to Latest

Legacy Mode

You can pass the second argument true to enable legacy mode when calling mdEnhancePlugin, and the plugin will try to run with V1 behavior.

New Features

• v-pre support

  The following container support is removed, so vPre option is added

  ::: v-pre
  
  Some {{vue syntax}}.
  
  :::

• Use component code block to add components easily

• Chart.js support

  Adds chart.js support via chart option

  ::: chartjs Title
  
  ```json
  {
    // chart.js config
  }
  ```
  
  :::
  
  ::: chartjs Title
  
  ```js
  const config = {
    // chart.js config
  };
  ```
  
  :::

• ECharts support

  Adds ECharts support via echarts option

  ::: echarts Title
  
  ```json
  {
    // chart.js config
  }
  ```
  
  :::
  
  ::: echarts Title
  
  ```js
  const option = {
    // chart.js config
  };
  ```
  
  :::

• content include support

  Use <!-- @include: --> to include other file content in Markdown via include options.

  Use <!-- @include: filename --> to include a file.

  To partially import the file, you can specify the range of lines to be included:

  • <!-- @include: filename{start-end} -->
  • <!-- @include: filename{start-} -->
  • <!-- @include: filename{-end} -->

  Also, you can include file region:

  • <!-- @include: filename#region -->

• markmap support

  Add markmap container to create Markmap via markmap option.

• Playground

  Embed interactive demo with official presets and custom options

• Kotlin Playground

  Provide Kotlin playground via kotlin-playground

• Vue Playground

  Provide Vue playground via @vue/repl

Changed

• Now all options are disabled by default

• Code demo syntax changed

  Before:

  ::: demo Title
  
  <!-- demo content -->
  
  :::
  
  ::: demo [vue] Title
  
  <!-- demo content -->
  
  :::
  
  ::: demo [react] Title
  
  <!-- demo content -->
  
  :::

  After:

  ::: normal-demo Title
  
  <!-- demo content -->
  
  :::
  
  ::: vue-demo Title
  
  <!-- demo content -->
  
  :::
  
  ::: react-demo Title
  
  <!-- demo content -->
  
  :::

Removed Options

• enableAll removed

  There are too many noob users who don't know what they are doing, and they just enable this option without using all the feature provided, yet they complain about load speed.

• lineNumbers removed

  VuePress 2 supports line number config per code block now.

• imageFix removed

  Mr.Hope already made a PR to fix broken image links in Markdown, so it's no longer needed

• alert removed

  Please use @vuepress/plugin-markdown-hint instead

• container, hint removed

  Please use @vuepress/plugin-markdown-hint instead

• imageLazyload, lazyload imgLazyload removed

  Please use @vuepress/plugin-markdown-image instead

• imageTitle, figure removed

  Please use @vuepress/plugin-markdown-image instead

• imageMark, imgMark removed

  Please use @vuepress/plugin-markdown-image instead

• imgSize, imageSize removed

  Please use @vuepress/plugin-markdown-image instead

• tex, katex, mathjax removed

  Please use @vuepress/plugin-markdown-math instead

• codegroup, codetabs removed

  Please use @vuepress/plugin-markdown-tab instead

• tabs removed

  Please use @vuepress/plugin-markdown-tab instead

• presentation revealJs revealjs removed

  Please use @vuepress/plugin-revealjs instead

Options Adjustments in Pre-release Version

• mdImport is renamed to include

• vpre is renamed to vPre

• card is replaced by components

• mermaid vuePlayground no longer accept lib options