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

86 lines
1.5 KiB
Markdown

---
title: Bilibili Video
icon: ri:bilibili-fill
createTime: 2025/10/08 12:26:47
permalink: /en/guide/embed/video/bilibili/
---
## Overview
The theme provides the capability to embed Bilibili videos.
This feature is powered by [vuepress-plugin-md-power](../../config/plugins/markdownPower.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: {
bilibili: true, // [!code ++]
},
})
})
```
## Syntax
Simple syntax:
```md
@[bilibili](bvid)
```
For videos with multiple parts, add `p1`, `p2`, `p3` etc. after `bilibili`:
```md
@[bilibili p1](aid cid)
```
More options:
```md
@[bilibili p1 autoplay time="0" width="100%" height="400px" ratio="16:9"](bvid aid cid)
```
**Parameter Description:**
- bvid: Video BV ID
- aid: Video AID
- cid: Video CID
- autoplay: Whether to enable autoplay
- time: Video playback start 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`
For videos with multiple parts, `bvid` can be omitted, but `aid` and `cid` must be provided.
## Examples
### Widescreen Video
Input:
```md
@[bilibili](BV1EZ42187Hg)
```
Output:
@[bilibili](BV1EZ42187Hg)
### Vertical Video
Input:
```md
@[bilibili width="320px" ratio="9:16"](BV1zr42187eg)
```
Output:
@[bilibili width="320px" ratio="9:16"](BV1zr42187eg)