---
url: https://ain.hmgf.hxcn.space/contribution/project-components/kbd.md
description: HeroUI 风格的键盘按键组件，支持 Win、Linux、Mac 常见快捷键与美式键盘常用按键展示。
---

# Kbd 组件

`Kbd` 用于在文档中展示快捷键、命令提示和单个按键说明。

## 基础用法

```md
<Kbd key-name="Enter" />
<Kbd key-name="Tab" />
<Kbd keys="Ctrl+K" platform="win" />
<Kbd keys="Command+K" platform="mac" />
```

## 常见平台快捷键

```md
<Kbd keys="Meta+R" platform="win" />
<Kbd keys="Ctrl+Shift+P" platform="win" />
<Kbd keys="Alt+Tab" platform="win" />
<Kbd keys="Ctrl+Shift+Esc" platform="win" />
```

```md
<Kbd keys="Super+L" platform="linux" />
<Kbd keys="Ctrl+Alt+T" platform="linux" />
<Kbd keys="Ctrl+Shift+Esc" platform="linux" />
<Kbd keys="Ctrl+Alt+Delete" platform="linux" />
```

```md
<Kbd keys="Command+Space" platform="mac" />
<Kbd keys="Command+Shift+4" platform="mac" />
<Kbd keys="Command+Option+Esc" platform="mac" />
<Kbd keys="Command+Tab" platform="mac" />
```

## 常见快捷键对应的代码

| 场景 | 演示 | Markdown 代码 |
| --- | --- | --- |
| Windows 运行窗口 |  | `<Kbd keys="Meta+R" platform="win" />` |
| Windows 命令面板 |  | `<Kbd keys="Ctrl+Shift+P" platform="win" />` |
| Linux 终端 |  | `<Kbd keys="Ctrl+Alt+T" platform="linux" />` |
| Linux 锁屏 |  | `<Kbd keys="Super+L" platform="linux" />` |
| macOS Spotlight |  | `<Kbd keys="Command+Space" platform="mac" />` |
| macOS 截图 |  | `<Kbd keys="Command+Shift+4" platform="mac" />` |

## 常见按键

## 在提示块中使用

## Props

| 参数 | 类型 | 默认值 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| `keys` | `string \| string[]` | `''` | 快捷键组合，使用 `+` 分隔。 | `keys="Ctrl+Shift+P"` |
| `keyName` | `string` | `''` | 单个按键名称；适合单键展示。 | `key-name="Enter"` |
| `platform` | `auto \| win \| linux \| mac` | `auto` | 平台映射规则。 | `platform="mac"` |
| `size` | `sm \| md \| lg` | `md` | 键帽尺寸。 | `size="lg"` |
| `separator` | `string` | `+` | 组合键分隔符。 | `separator="/"` |