Overview

The theme supports embedding PDF files in markdown, enabling direct PDF reading within the page.

This feature is powered by vuepress-plugin-md-power.

Configuration

This feature is disabled by default. You need to enable it in the theme configuration.

.vuepress/config.ts

export default defineUserConfig({
  theme: plumeTheme({
    markdown: {
      pdf: true, 
    },
  })
})

Syntax

The simplest syntax is as follows:

@[pdf](url)

To open a specific page, use the page option. The shorthand @[pdf 2](url) is also supported for backward compatibility.

@[pdf page="2"](url)

Additional options can be added to @[pdf ] for more flexible control:

@[pdf page="2" width="100%" ratio="16:9"](url)

• page - Page number, defaults to 1
• width - Width, defaults to 100%
• height - Height, defaults to auto
• ratio - Aspect ratio, defaults to 1:0.9, only effective when height is not specified

Examples

Default

Input:

@[pdf](https://plume.pengzhanbo.cn/files/sample-1.pdf)

Output:

Set Page Number to 2

Input:

@[pdf page="2"](https://plume.pengzhanbo.cn/files/sample-1.pdf)

Output:

Fixed Height

Input:

@[pdf height="400px"](https://plume.pengzhanbo.cn/files/sample-1.pdf)

Output:

21:29 Aspect Ratio

Input:

@[pdf ratio="21:29"](https://plume.pengzhanbo.cn/files/sample-1.pdf)

Output:

Contributors

pengzhanbo

Changelog

9/16/26, 6:24 PM

View All Changelog

• 685a2-feat(plugin-md-power): enhance pdf embed syntax (#997)on 9/16/26
• 1d04d-feat: add builtin auto-import-components (#932)on 9/9/26
• c4637-docs: update pdf assetson 1/20/26
• 38505-docs: update en docs (#708)on 10/9/25

Edit this page

Previous pagePlantUML

Next pageBilibili Video