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

82 lines
1.4 KiB
Markdown

---
title: Code Pen
icon: mingcute:codepen-line
createTime: 2025/10/08 10:41:58
permalink: /en/guide/code/code-pen/
---
The theme supports embedding [CodePen](https://codepen.io/) in Markdown files.
## Configuration
This feature is disabled by default. You can enable it in the configuration file.
```ts title=".vuepress/config.ts"
export default defineUserConfig({
theme: plumeTheme({
markdown: {
codepen: true, // [!code highlight]
},
})
})
```
## Syntax
Basic syntax:
```md
@[codepen](user/slash)
```
Extended options support:
```md
@[codepen preview editable tab="css,result" theme="dark" height="500px" width="100%"](user/slash)
```
- `preview`: Whether to render in preview mode
- `editable`: Whether the content is editable
- `tab`: Default active tabs, defaults to `result`, multiple tabs separated by `,`
- `theme`: Theme, options: `dark` and `light`
- `height`: Container height, defaults to `400px`
- `width`: Container width, defaults to `100%`
- `user`: CodePen username
- `slash`: CodePen pen slug/identifier
## Examples
Input:
```md
@[codepen](leimapapa/RwOZQOW)
```
Output:
@[codepen](leimapapa/RwOZQOW)
**Preview Mode:**
Input:
```md
@[codepen preview](leimapapa/RwOZQOW)
```
Output:
@[codepen preview](leimapapa/RwOZQOW)
**Editable Mode:**
Input:
```md
@[codepen editable tab="html,result"](leimapapa/RwOZQOW)
```
Output:
@[codepen editable tab="html,result"](leimapapa/RwOZQOW)