入门
安装
通过创建一个新项目或将其添加到现有 Nuxt 应用程序中来开始使用 Nuxt 内容。
在线体验
您可以使用我们的在线沙盒在浏览器中开始体验 Nuxt 内容。
在 StackBlitz 上体验在 CodeSandbox 上体验或打开嵌入式游乐场。
新项目
在开始之前,请确保已安装推荐的设置。
- 按照Nuxt 3 先决条件操作。
- 下载VS Code MDC 扩展
- 您可以使用以下命令开始一个全新的 Nuxt 内容项目。
终端
npx nuxi@latest init content-app -t content
它会询问您要使用哪个包管理器来安装依赖项。
- 移至
content-app
文件夹并启动开发服务器。
pnpm run dev
✨ 恭喜!浏览器窗口应自动打开 https://127.0.0.1:3000
👉 下一步是前往写作部分了解如何使用 Nuxt 内容。
添加到项目中
您可以在 Nuxt 项目开发过程中的任何时间添加 Nuxt 内容,方法是安装 @nuxt/content
模块。
npx nuxi@latest module add content
然后,将 @nuxt/content
添加到 nuxt.config.ts
的 modules
部分。
nuxt.config.ts
export default defineNuxtConfig({
modules: [
'@nuxt/content'
],
content: {
// ... options
}
})
创建内容
将您的 Markdown 文件放在项目根目录的 content/
目录中。
content/index.md
# Hello Content
该模块会自动加载并解析它们。
渲染页面
要渲染内容页面,请使用 ContentDoc
组件添加一个通配符路由。
pages/[...slug].vue
<template>
<main>
<ContentDoc />
</main>
</template>
⚠️ 如果您在项目的根目录下有一个
app.vue
文件,请确保在它的模板中包含 <NuxtPage />
来渲染页面。⚠️ Content v2 要求使用Nuxt 3。如果您使用的是 Nuxt 2,请查看Content v1 文档。
👉 下一步是前往写作部分了解如何使用 Nuxt 内容。