Article Watermark
Overview
Article watermarking is powered by @vuepress/plugin-watermark.
The theme supports adding watermarks to articles. Both full-page watermarks and content-area watermarks are supported, along with image watermarks and text watermarks.
For configuration options, please refer to Configuration > Watermark.
Enabling Watermark
Watermark functionality is disabled by default in the theme. You need to enable it in the theme configuration.
import { defineUserConfig } from 'vuepress'
import { plumeTheme } from 'vuepress-theme-plume'
export default defineUserConfig({
theme: plumeTheme({
// watermark: true,
watermark: {
// enabled: false, // boolean type to control global enablement
enabled: page => true, // function type to filter which pages enable watermark
/**
* Whether to use full-page watermark, defaults to `true`.
* When set to `false`, the watermark is only displayed in the content area.
*/
fullPage: true,
/** @see https://zhensherlock.github.io/watermark-js-plus/zh/config/ */
watermarkOptions: {
content: 'your watermark',
// ...
}
}
})
})Global Enablement
When the top-level watermark is set to true, the theme enables watermark globally.
Equivalent form: configure it at the lower-level entry plugins.watermark: true. The two are different entries and do not override each other; the top-level entry takes precedence.
export default defineUserConfig({
theme: plumeTheme({
watermark: true,
})
})Partial Page Enablement
The theme provides two methods to control watermark enablement on specific pages.
watermark.enabled
export default defineUserConfig({
theme: plumeTheme({
watermark: {
// Pages returning true will enable watermark, others will disable it
enabled: page => page.path.includes('/article/'),
}
})
})frontmatter.watermark
Add frontmatter.watermark as true in the md file:
---
watermark: true
---You can also customize the watermark configuration for the current page:
---
watermark:
content: My Custom Content
globalAlpha: 0.2
rotate: 45
---Image Watermark
The theme supports using images as watermarks.
import { defineUserConfig } from 'vuepress'
import { plumeTheme } from 'vuepress-theme-plume'
export default defineUserConfig({
theme: plumeTheme({
watermark: {
watermarkOptions: {
contentType: 'image',
image: '/images/watermark.png',
width: 200,
height: 200,
imageWidth: 100,
imageHeight: 100,
}
}
})
})You can also add configuration in the md file to set watermark for the current page:
---
watermark:
contentType: image
image: /images/watermark.png
width: 200
height: 200
imageWidth: 100
imageHeight: 100
---Example
Text Watermark
The theme supports using text as watermarks.
import { defineUserConfig } from 'vuepress'
import { plumeTheme } from 'vuepress-theme-plume'
export default defineUserConfig({
theme: plumeTheme({
watermark: {
watermarkOptions: {
content: 'Custom Text',
fontColor: '#fff', // Text color
}
}
})
})You can also add configuration in the md file to set watermark for the current page:
---
watermark:
content: Custom Text
fontColor: #fff
---Frontmatter
The theme supports adding frontmatter.watermark in md files to set watermarks for individual pages.
---
watermark:
content: My Custom Content
---For supported configuration options, please refer to: watermark-js-plus
Additionally, fullPage is supported to control whether to display the watermark full-screen.
---
watermark:
fullPage: false
---Examples
Limitations
The watermark is client-side only
The watermark is rendered in the browser by @vuepress/plugin-watermark and is not baked into the build output. This means:
- The full content still exists in the page HTML and source files — the watermark is only a visual overlay
- Disabling JavaScript or viewing the source reveals the original content
- It is not suitable for any scenario that requires real confidentiality
For content protection, use the encryption feature instead.
Full-screen vs. content watermark
- Full-screen watermark: covers the entire viewport, better at discouraging screenshot leaks
- Content watermark: covers only the article area, leaving navbar and sidebar untouched
Both can be combined with text or image watermarks.
