Markdown

如何使用 MDC 语法编写文档.

VS Code 集成

MDC 扩展

Nuxt MDC 是一个 VS Code 扩展,提供 MDC 语法的语法高亮和自动补全功能. 启动 VS Code 快速打开 Ctrl + P,粘贴以下命令并按回车。

ext install Nuxt.mdc

启用组件元数据补全

VSCode 设置

.vscode/settings.json
{
  "mdc.enableComponentMetadataCompletions": true}

安装 nuxt-component-meta 模块

将 nuxt-component-meta 依赖添加到你的项目中:

npm
pnpm
bun
yarn
npm i nuxt-component-meta

将 nuxt-component-meta 添加到你的 nuxt.config.ts 的 modules 部分, 并可选择性地配置该模块:

nuxt.config.ts
export default defineNuxtConfig({
  modules: ['nuxt-component-meta'],
});

一旦您的项目在开发服务器上完成构建或运行, 该扩展程序将自动扫描项目中的组件元数据, 并基于发现的组件提供建议, 无需任何额外配置.

提示

从目录中隐藏标题

0.4.7

将标题的 id 属性设置为 hide-toc, 即可隐藏该标题在目录中的显示.

:h2[Footnotes]{id="hide-toc"}