Overview

The theme provides the capability to embed YouTube videos.

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: {
      youtube: true, 
    },
  })
})

Syntax

Simple syntax:

@[youtube](id)

More options:

@[youtube autoplay loop start="0" end="0" width="100%" height="400px" ratio="16:9"](id)

Parameter Description:

Name:id

Required

Type:string

Video ID

Name:autoplay

Optional

Type:boolean

Whether to enable autoplay

Name:loop

Optional

Type:boolean

Whether to enable loop playback

Name:start

Optional

Type:number | string

Video playback start time in seconds, or in mm:ss or hh:mm:ss format

Name:end

Optional

Type:number | string

Video playback end time in seconds, or in mm:ss or hh:mm:ss format

Name:width

Optional

Type:string

Default:100%

Video width

Name:height

Optional

Type:string

Video height. When not specified, it is handled as automatic height

Name:ratio

Optional

Type:string

Default:16:9

Video aspect ratio

Examples

Widescreen Video

Input:

@[youtube](0JJPfz5dg20)

Output:

Contributors

pengzhanbo

Changelog

10/13/26, 3:56 PM

View All Changelog

• e4dae-docs: improve docs (#1071)on 10/13/26
• 38505-docs: update en docs (#708)on 10/9/25

Edit this page

Previous pageAcFun Video

Next pageArtPlayer Video