---
title: YouTube Video
icon: mdi:youtube
createTime: 2025/10/08 14:30:33
permalink: /en/guide/embed/video/youtube/
---

## Overview

The theme provides the capability to embed YouTube videos.

This feature is powered by [vuepress-plugin-md-power](../../config/plugins/markdown-power.md).

## Configuration

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

```ts title=".vuepress/config.ts"
export default defineUserConfig({
  theme: plumeTheme({
    markdown: {
      youtube: true, // [!code ++]
    },
  })
})
```

## Syntax

Simple syntax:

```md
@[youtube](id)
```

More options:

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

**Parameter Description:**

- id: Video ID
- autoplay: Whether to enable autoplay
- loop: Whether to enable loop playback
- start: Video playback start time in seconds, or in `mm:ss` or `hh:mm:ss` format
- end: Video playback end time in seconds, or in `mm:ss` or `hh:mm:ss` format
- width: Video width
- height: Video height
- ratio: Video aspect ratio, defaults to `16:9`

## Examples

### Widescreen Video

Input:

```md
@[youtube](0JJPfz5dg20)
```

Output:

@[youtube](0JJPfz5dg20)