VuePress 生态系统VuePress 生态系统
  • 主题指南
  • 默认主题
  • Hope 主题
  • Plume 主题
  • Reco 主题
  • 功能插件
  • Markdown 插件
  • 搜索插件
  • 博客插件
  • 渐进式应用插件
  • 统计分析插件
  • 搜索引擎优化插件
  • 开发插件
  • 工具插件
  • @vuepress/helper
  • English
  • 简体中文
GitHub
  • 主题指南
  • 默认主题
  • Hope 主题
  • Plume 主题
  • Reco 主题
  • 功能插件
  • Markdown 插件
  • 搜索插件
  • 博客插件
  • 渐进式应用插件
  • 统计分析插件
  • 搜索引擎优化插件
  • 开发插件
  • 工具插件
  • @vuepress/helper
  • English
  • 简体中文
GitHub
  • append-date
  • markdown-container
  • markdown-ext
  • markdown-image
  • markdown-include
  • markdown-hint
  • markdown-math
  • markdown-stylize
  • markdown-tab
  • links-check
  • prismjs
  • revealjs
    • revealjs
    • 幻灯片演示
    • 幻灯片主题
  • shiki

links-check

@vuepress/plugin-links-check

此插件将检查您的 markdown 文件中的死链接。

此插件已集成到默认主题中。

使用

npm i -D @vuepress/plugin-links-check@next
.vuepress/config.ts
import { linksCheckPlugin } from '@vuepress/plugin-links-check'

export default {
  plugins: [
    linksCheckPlugin({
      // 选项
    }),
  ],
}

选项

dev

  • 类型:boolean

  • 默认值:true

  • 详情:

    是否在开发服务器中检查 markdown 中的死链接

build

  • 类型:boolean | 'error'

  • 默认值:true

  • 详情:

    是否在构建中检查 markdown 中的死链接。如果设置为 'error',则构建将在存在死链接时失败。

exclude

  • 类型:(string | RegExp)[] | ((link: string, isDev: boolean) => boolean)

  • 详情:

    应该从检查中排除的链接。您可以使用字符串或正则表达式的列表,或者返回布尔值的函数。

  • 示例:

    .vuepress/config.ts
    import { linksCheckPlugin } from '@vuepress/plugin-links-check'
    
    export default {
      plugins: [
        linksCheckPlugin({
          exclude: [
            // 通过字符串排除链接
            '/exclude-link',
            // 通过正则表达式排除链接
            /\/exclude-link-regex/,
          ],
    
          // 或者通过函数排除链接
          exclude: (link, isDev) => {
            if (isDev) {
              return link.startsWith('/exclude-link-dev')
            }
            return link.startsWith('/exclude-link-build')
          },
        }),
      ],
    }
在 GitHub 上编辑此页
上次更新: 2025/4/12 19:03
贡献者: Mister-Hope
Prev
markdown-tab
Next
prismjs