# Code

语法高亮代码块 — Shiki 转换器支持文件名框架、行高亮、差异标记、聚焦、错误/警告标注和词语高亮。

**Install:** `nimbus-docs add code`  
**Source:** `src/components/ui/code/`  
**Canonical:** https://nimbus-docs.cn/components/code/

## Agent payload (JSON)

```json
{
  "slug": "code",
  "name": "Code",
  "description": "Inline / block code wrapper. Re-exports Astro's built-in <Code> (Shiki).",
  "tagline": "语法高亮代码块 — Shiki 转换器支持文件名框架、行高亮、差异标记、聚焦、错误/警告标注和词语高亮。",
  "install": "nimbus-docs add code",
  "sourcePath": "src/components/ui/code/",
  "canonicalUrl": "https://nimbus-docs.cn/components/code/",
  "props": [
    {
      "name": "code",
      "type": "string",
      "required": true,
      "description": "要高亮的源代码字符串。"
    },
    {
      "name": "lang",
      "type": "string",
      "required": true,
      "description": "语言标识符（例如 \"ts\"、\"tsx\"、\"bash\"）。"
    },
    {
      "name": "meta",
      "type": "string",
      "required": false,
      "description": "Shiki 元信息 — 例如 `title=\"src/foo.ts\" {1,3-5}` 用于文件名 + 高亮。"
    },
    {
      "name": "raw",
      "type": "boolean",
      "defaultValue": "false",
      "required": false,
      "description": "原样渲染源代码 — 跳过 `// [!code ++]` / focus 等标注转换器。"
    },
    {
      "name": "lineNumbers",
      "type": "boolean",
      "defaultValue": "false",
      "required": false,
      "description": "渲染带行号的装订线。"
    }
  ],
  "registryDependencies": [
    "cn"
  ],
  "dependencies": []
}
```