概述

环境预设 (markdown.env) 可以用来配置一些 Markdown 渲染环境的预设值， 比如 引用链接、内容注释、缩写词等，从而避免在每个 markdown 文件中重复定义。

环境预设在 任意 markdown 文件中都可以生效。

配置

.vuepress/config.ts

export default defineUserConfig({
  theme: plumeTheme({
    markdown: {
      env: {
        // 引用链接
        references: {
          vuepress: 'https://v2.vuepress.vuejs.org/'
        },
        // 缩写词
        abbreviations: {
          HTML: 'Hypertext Markup Language'
        },
        // 内容注释
        annotations: {
          vuepress: 'VuePress 是一个 [静态站点生成器](https://en.wikipedia.org/wiki/Static_site_generator) (SSG) 。专为构建快速、以内容为中心的站点而设计。'
        }
      }
    }
  })
})

以上配置等同于在 任意 markdown 文件中：

[vuepress]: https://v2.vuepress.vuejs.org/

*[HTML]: Hypertext Markup Language

[+vuepress]: VuePress 是一个 [静态站点生成器](https://en.wikipedia.org/wiki/Static_site_generator) (SSG) 。专为构建快速、以内容为中心的站点而设计。

因此，可以在任意 markdown 文件中使用这些环境预设：

链接引用：[vuepress][vuepress]

缩写词：HTML

内容注释：vuepress [+vuepress]

链接引用：vuepress

缩写词：HTML

内容注释：vuepress

Interface

interface MarkdownEnvPreset {
  /**
   * 引用链接
   */
  references?: {
    [label: string]: string | { title?: string, href: string }
  }
  /**
   * 缩写词
   */
  abbreviations?: {
    [label: string]: string
  }
  /**
   * 内容注释
   */
  annotations?: {
    [label: string]: string | string[]
  }
}

贡献者

pengzhanbo

更新日志

2026/1/19 13:41

查看所有更新日志

• f51df-feat(plugin-md-power): add markdown env presets, #815 (#818)于 2026/1/19

编辑此页

上一页导入文件

下一页介绍