入门

安装

通过创建一个新项目或将其添加到现有 Nuxt 应用程序中来开始使用 Nuxt 内容。

在线体验

您可以使用我们的在线沙盒在浏览器中开始体验 Nuxt 内容。

在 StackBlitz 上体验在 CodeSandbox 上体验

或打开嵌入式游乐场

新项目

在开始之前,请确保已安装推荐的设置。
  1. 您可以使用以下命令开始一个全新的 Nuxt 内容项目。
终端
npx nuxi@latest init content-app -t content

它会询问您要使用哪个包管理器来安装依赖项。

  1. 移至 content-app 文件夹并启动开发服务器。
pnpm run dev
✨ 恭喜!浏览器窗口应自动打开 https://127.0.0.1:3000
👉 下一步是前往写作部分了解如何使用 Nuxt 内容。

添加到项目中

⚠️ Nuxt 内容要求 ssr: true(默认值)在Nuxt 配置中设置。带有 ssr: false 的 Nuxt 应用程序将生成一个单页面应用程序,它目前与预渲染 Nuxt 内容文件不兼容。

您可以在 Nuxt 项目开发过程中的任何时间添加 Nuxt 内容,方法是安装 @nuxt/content 模块。

npx nuxi@latest module add content

然后,将 @nuxt/content 添加到 nuxt.config.tsmodules 部分。

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 内容。