vuepress-theme-plume/docs/en/config/plugins/markdown-include.md
pengzhanbo 385059f214
docs: update en docs (#708)
* docs: update en docs

* chore: tweak

* chore: tweak

* chore: tweak
2025-10-09 15:46:05 +08:00

1.4 KiB

title, createTime, permalink
title createTime permalink
Markdown Include 2025/10/09 12:01:58 /en/config/plugins/markdown-include/

Overview

Import content from other markdown files within Markdown files.

Related plugin: @vuepress/plugin-markdown-include

Configuration

The theme enables markdownInclude by default. You can further customize its behavior through configuration.

export default defineUserConfig({
  theme: plumeTheme({
    markdown: {
      include: {
        // ... options
      }
    },
    // Can also be configured in `plugins.markdownInclude`, but not recommended
    plugins: {
      markdownInclude: {},
    }
  })
})

resolvePath

  • Type: (path: string, cwd: string | null) => string
  • Default: (path) => path
  • Details: Processes the include file path.

deep

  • Type: boolean
  • Details: Whether to enable deep include support.

useComment

  • Type: boolean
  • Default: true
  • Details: Whether to use <!-- @include: xxx --> instead of @include: xxx for file inclusion.

resolveImagePath

  • Type: boolean
  • Default: true
  • Details: Whether to resolve relative image paths within the included Markdown files.

resolveLinkPath

  • Type: boolean
  • Default: true
  • Details: Whether to resolve relative file paths within the included Markdown files.