MDC 组件

在 Markdown 中用 MDC 语法嵌入 Nuxt UI 的 Prose 组件:提示块、徽标、卡片、折叠面板、选项卡、步骤、字段说明、图标与按键,无需编写 Vue 代码即可组织更有层次的文档内容。
查看源码

MDC 语法 允许在 Markdown 中使用 Vue 组件:块级组件写作 ::name,行内组件写作 :name,属性放在 {} 或 YAML 块中,嵌套时每层多加一个冒号。

本页只列出文档中最常用的 Prose 组件。任何全局注册的 Vue 组件都能以同样的方式在 Markdown 中使用,完整列表见 Nuxt UI 文档。

Callout

提示块用于强调与正文并列的补充信息。note、tip、warning、caution 是预设了图标与颜色的快捷写法:

页面标题来自 frontmatter 的 title,正文从二级标题开始。
在 app.config.ts 中修改的配置无需重启开发服务器。
启用 AI Chat 时不能关闭 MCP Server。
不要把 NUXT_GITHUB_TOKEN 提交到公开仓库。
::

## `Icon`

`icon` 渲染任意 [Iconify](https://icones.js.org/) 图标,名称格式为 `i-{集合}-{图标}`:

::code-preview
:icon{name="i-simple-icons-nuxtdotjs" class="size-6"} :icon{name="i-lucide-book-open" class="size-6"}

#code
```mdc
:icon{name="i-simple-icons-nuxtdotjs" class="size-6"} :icon{name="i-lucide-book-open" class="size-6"}

::

Kbd

kbd 显示键盘按键,meta 在 macOS 上显示为 ⌘,在其他系统上显示为 Ctrl:

按 Ctrl K 打开搜索。
按 :kbd{value="meta"} :kbd{value="K"} 打开搜索。
Copyright © 2024 - 2026