NuxtVue博客

nuxt-content-template — Nuxt 博客模板

作者 data-miner00

基于 Nuxt Content 的 Markdown 博客模板，内置 i18n、暗色模式、TailwindCSS 与静态生成配置。

打开源站下载源码 ZIP

看看你的网站会是什么样

浏览真实页面截图，比较内容排版与手机效果。点击下方缩略图切换，放大查看整页细节。

3 个预览视图
桌面端首页1 / 3
桌面端截图首屏预览

由服务器浏览器实际访问页面后截取。

全部页面与视图 3

截图用于了解视觉与布局，交互效果请以实际项目为准。

采集于 2026-10-02查看来源

值得关注的模板亮点

从已有项目资料中，快速了解它的特点。

01

以 Markdown 为内容源，配合 Nuxt Content 渲染博客文章

02

支持在 Markdown 中嵌入 LaTeX 公式与化学方程式

03

内置 @nuxtjs/i18n 国际化与 @nuxtjs/color-mode 暗色模式

04

使用 TailwindCSS 编写样式，项目语言为 TypeScript

05

代码块具备高亮、行号与复制按钮

06

集成 nuxt-seo-kit 生成 sitemap.xml、robots.txt 并优化元数据

模板详细介绍

这是一个面向 Markdown 博客的 Nuxt 模板，作者称其为「opinionated」，即已预先确定技术选型与目录结构，使用者主要编写 Markdown 内容而非从零配置。内容层使用 Nuxt Content，样式使用 TailwindCSS，语言为 TypeScript，并集成 @nuxtjs/i18n 实现国际化、@nuxtjs/color-mode 实现暗色模式。

功能方面，模板支持 Markdown 文章，并可通过 rehype-mathjax 与 remark-math 在 Markdown 中嵌入 LaTeX 公式（含化学方程式）；代码块提供高亮、行号与复制按钮。SEO 依赖 nuxt-seo-kit，可生成 sitemap.xml、robots.txt 并优化站点元数据；图片优化使用 @nuxt/image；交互与动画使用 @vueuse/core 与 @vueuse/motion。模板包含 404 页面，并支持静态站点生成。

限制与注意事项：README 明确要求保持 Nuxt 与 Nuxt Content 的既有版本不变，升级这两个包会破坏静态站点生成；同时警告不要更新依赖。开发环境使用 pnpm，锁文件基于 Node v20.9.0 生成，README 声明支持 Node 18 与 Node 20。静态生成前需将 .env.example 复制为 .env 并设置 NUXT_PUBLIC_SITE_UR。拼写检查需自行安装 crates-ci/typos。PWA Manifest 与 DocSearch 在路线图中仍为未完成项。

NuxtVue博客

适合你的项目吗？

适用场景

  • 搭建以 Markdown 写作的个人技术博客或笔记站点
  • 需要多语言与暗色模式的内容型网站
  • 需要静态生成、便于部署到静态托管平台的博客
  • 文章中需要展示数学公式或化学方程式的写作场景

适合人群

  • 习惯用 Markdown 写作、不想自行搭建渲染流程的开发者
  • 接受模板既定技术选型、希望直接开始写内容的个人博主
  • 需要 i18n 与暗色模式等常见博客能力的 Nuxt 使用者

上手与定制指南

结合仓库当前版本的说明，按下面的资料检查内容、配置与运行要求。

  1. 1

    克隆仓库后使用 pnpm i 安装依赖，pnpm dev 启动开发服务器

  2. 2

    将 .env.example 复制为 .env，并设置 NUXT_PUBLIC_SITE_UR 用于静态生成

  3. 3

    执行 pnpm generate 生成静态站点

  4. 4

    README 警告不要更新依赖，Nuxt 与 Nuxt Content 的既有版本需保持不变

  5. 5

    锁文件基于 Node v20.9.0 生成，README 声明支持 Node 18 与 Node 20

查看仓库使用说明

授权与来源资料

使用条件与限制

免费使用 · 保留许可声明

本次收录的是公开仓库中采用 MIT 许可的免费版本；免费范围为该版本代码，不代表外部服务或第三方素材免费。

使用时需要遵守

  • 允许免费使用、修改、商用和分发该版本代码。
  • 分发代码副本或实质性部分时，保留原作者版权声明和完整 MIT 许可声明。
  • 代码按现状提供；担保与责任限制以原许可证及适用法律为准。

额外费用与待核对事项

  • 必须保持 Nuxt 3.6.1 与 Nuxt Content 2.7.0 的版本不变，升级这两个包会破坏静态站点生成。
  • 不要更新依赖，否则会因最新 Nuxt 与 Nuxt Content 的不兼容而损坏项目。
  • 拼写检查功能需自行从 crates-ci/typos 安装外部工具，模板本身不包含该工具。
  • 静态生成前需将 .env.example 复制为 .env 并设置 NUXT_PUBLIC_SITE_UR 环境变量。
  • 演示图片、字体、图标及其他第三方素材需按各自许可核对，不能仅凭代码的 MIT 许可判断。
  • 域名、托管、数据库、支付或 AI 等外部服务可能另外收费。
查看原文依据

Permission is hereby granted, free of charge

许可证原文

The version for Nuxt (3.6.1) and Nuxt Content (2.7.0) must remain. Updating the version for these two packages will break the static site generation.

README 原文

**Do not update** the dependencies as it will break due to incompatibilities from the latest Nuxt and Nuxt Content.

README 原文

Typo checking (need to install from [crates-ci/typos](https://github.com/crate-ci/typos))

README 原文

Copy the `.env.example` to `.env` and replace the value for `NUXT_PUBLIC_SITE_UR`. This is used for static-site generation.

README 原文
https://github.com/data-miner00/nuxt-content-template/blob/master/LICENSEhttps://github.com/data-miner00/nuxt-content-template/blob/master/README.md

DeepSeek 根据仓库许可证和 README 整理 ·2026-10-02。结果仅覆盖已读取资料，依赖、图片、字体及后续条款变更以各自原文为准。

项目核对记录与介绍依据

模板资料

来源平台
GitHub
资料与维护参考分
资料较完整 · 86 / 100
技术栈
Nuxt · Vue
网站类型
博客
这个分数如何计算

本站按许可资料（最高30分）、演示链接（12分）、预览图（10分）、Star数（15分）、记录的维护时间（15分）、描述完整度（8分）、功能记录（5分）和分类资料（5分）计算。它不是代码、安全或性能测试，也不是 Google 评分；有链接不代表已实测可用。

这个项目需要核对什么

记录的仓库更新时间
2025-02-19
截图检查日期
2026-10-02

已收录演示链接。请用你的内容与屏幕尺寸检查；有演示不代表表单、认证或支付已经可用。

目录记录的主要技术栈是 Nuxt。请通过依赖清单和锁文件核对实际版本与托管要求。这些说明基于收录资料，不代表代码审计或部署实测。

查看具体选型方法 →

介绍的制作与核对状态

介绍由 AI 辅助整理目录与仓库资料。仓库作者不等于这篇介绍的审核者。

已完成服务器许可规则与 AI 来源核对；未经过人工编辑审核。

查看当时使用的来源资料

SHA-256: 166a29044b5172e69a6d67c9deb7a7c0614b32585fcc35fa64f81cd445515558

2026-10-02T17:25:56.328Z

来源文件 / 仓库
<a name="readme-top"></a>

<!-- PROJECT SHIELDS -->

[![Contributors][contributors-shield]][contributors-url]
[![Forks][forks-shield]][forks-url]
[![Stargazers][stars-shield]][stars-url]
[![Issues][issues-shield]][issues-url]
[![MIT License][license-shield]][license-url]

<!-- PROJECT LOGO -->
<br />
<div align="center">
  <a href="/">
    <img src="assets/images/nuxt-content.png" />
  </a>

  <h3 align="center">Nuxt Content Template</h3>

  <p align="center">
    An opionionated Nuxt.js Template with Nuxt Content!
    <br />
    <a href="https://nuxt-content-template.netlify.app/"><strong>View Demo »</strong></a>
    <br />
    <br />
    <a href="https://github.com/data-miner00/nuxt-content-template">Explore the docs</a>
    ·
    <a href="https://github.com/data-miner00/nuxt-content-template/issues">Report Bug</a>
    ·
    <a href="https://github.com/data-miner00/nuxt-content-template/issues">Request Feature</a>
  </p>
</div>

<!-- TABLE OF CONTENTS -->
<details>
  <summary>Table of Contents</summary>
  <ol>
    <li>
      <a href="#about-the-project">About The Project</a>
      <ul>
        <li><a href="#built-with">Built With</a></li>
        <li><a href="#features">Features</a></li>
      </ul>
    </li>
    <li>
      <a href="#getting-started">Getting Started</a>
      <ul>
        <li><a href="#prerequisites">Prerequisites</a></li>
        <li><a href="#installation">Installation</a></li>
      </ul>
    </li>
    <li><a href="#usage">Usage</a></li>
    <li><a href="#roadmap">Roadmap</a></li>
    <li><a href="#contributing">Contributing</a></li>
    <li><a href="#license">License</a></li>
    <li><a href="#acknowledgments">Acknowledgments</a></li>
  </ol>
</details>

<!-- ABOUT THE PROJECT -->

## About The Project

![Template screenshot](/assets/images/screenshot.png)

An extremely opinionated template for building Markdown oriented Nuxt websites with Nuxt Content and TailwindCSS. Focus on the development itself rather than low-level configurations.

Incentives:

- Wanted to build out my new personal website
- Want Markdown
- Want newest version of Vue, Nuxt and Nuxt Content (at the time).
- Build this multi-purpose template so I can use for other projects.

Projects that use this template:

- [notes.mumk.dev](https://notes.mumk.dev)

<p align="right">(<a href="#readme-top">back to top</a>)</p>

### Built With

The technologies and tools used within this template.

- Vue
- Nuxt
- Nuxt Content
- TailwindCSS
- TypeScript

The version for Nuxt (3.6.1) and Nuxt Content (2.7.0) must remain. Updating the version for these two packages will break the static site generation. Regardless, the existing version in my humble opinion is good enough to create a functional documentation/blogs.

<p align="right">(<a href="#readme-top">back to top</a>)</p>

### Features

This template currently offers the following features. For more info, please read the [guide](https://nuxt-content-template.netlify.app/guide).

- Markdown articles
- Markdown embeddable LaTeX (`rehype-mathjax`, `remark-math`)
  - Math Equations
  - [Chemical Equations](https://notes.mumk.dev/articles/general/latex#chemical-equations)
- Internationalization (i18n, `@nuxtjs/i18n`)
- Dark Mode (`@nuxtjs/color-mode`)
- Mobile responsive
- Styling with TailwindCSS
- Static-site generation
- Simple SEO (`nuxt-seo-kit`)
  - Auto-generated Sitemap.xml
  - robots.txt
  - Optimized site metadata
- Image optimization (`@nuxt/image`)
- Vue utilities
  - Powerful hooks (`@vueuse/core`)
  - Animation (`@vueuse/motion`)
- 404 Page (the `/resource` url does not exist)
- Ultra-fast loading speed
- Support for Node 18 and Node 20
- Typo checking (need to install from [crates-ci/typos](https://github.com/crate-ci/typos))
- Sass support (although I don't remember using it 😁)

Again, if you wish to grok what this template is capable of, consider visiting [my technical blog](https://notes.mumk.dev) to see it for yourself.

<p align="right">(<a href="#readme-top">back to top</a>)</p>

<!-- GETTING STARTED -->

## Getting Started

### Prerequisites

The list of tools that is used when development.

- npm
  ```sh
  npm install npm@latest -g
  ```
- Pnpm
  ```sh
  npm i -g pnpm
  ```
- [Git](https://git-scm.com/downloads)

### Installation

To run this template project in your local for personal use or contribution, simply perform the following.

1. Clone the repo
   ```sh
   git clone https://github.com/data-miner00/nuxt-content-template.git
   ```
2. Install Node dependencies
   ```sh
   pnpm i
   ```
3. Start the development server
   ```sh
   pnpm dev
   ```
4. Copy the `.env.example` to `.env` and replace the value for `NUXT_PUBLIC_SITE_UR`. This is used for static-site generation.
   ```sh
   NUXT_PUBLIC_SITE_UR=https://www.mydomain.com
   ```
5. Build/generate static website
   ```sh
   pnpm generate
   ```

<!-- prettier-ignore-start -->

> [!warning]
> **Do not update** the dependencies as it will break due to incompatibilities from the latest Nuxt and Nuxt Content.

<!-- prettier-ignore-end -->

> [!note]
> The current lockfile was generated with Node v20.9.0.

<p align="right">(<a href="#readme-top">back to top</a>)</p>

<!-- ROADMAP -->

## Roadmap

- [x] Add Dark Mode
- [x] Add i18n
- [x] Add Styling
  - [x] Sass
  - [x] Tailwind
- [ ] Add PWA Manifest
- [x] Responsive styles
- [ ] DocSearch
- [x] Copy code block button
- [x] Add line numbers to code block
- [x] Add highlight to code block
- [x] Add missing items to mobile navbar

See the [open issues](https://github.com/data-miner00/nuxt-content-template/issues) for a full list of proposed features (and known issues).

<p align="right">(<a href="#readme-top">back to top</a>)</p>

<!-- CONTRIBUTING -->

## Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are **greatly appreciated**.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement".
Don't forget to give the project a star! Thanks again!

1. Fork the Project
2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)
3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)
4. Push to the Branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request

<p align="right">(<a href="#readme-top">back to top</a>)</p>

<!-- LICENSE -->

## License

Distributed under the MIT License. See `LICENSE` for more information.

<p align="right">(<a href="#readme-top">back to top</a>)</p>

<!-- ACKNOWLEDGMENTS -->

## Acknowledgments

List of resources that are helpful and would like to give credit to.

- [Vue.js v3](https://vuejs.org/)
- [Nuxt v3](https://nuxt.com/)
- [Nuxt Content](https://content.nuxtjs.org)
- [Robots.txt](https://developers.google.com/search/docs/crawling-indexing/robots/intro)
- [enji.dev](https://www.enji.dev/)
- [How to Create a Custom Code Block With Nuxt Content v2](https://mokkapps.de/blog/how-to-create-a-custom-code-block-with-nuxt-content-v2/)
- [VueUse](https://vueuse.org/)
- [@nuxtjs/color-mode](https://color-mode.nuxtjs.org/)
- [Nuxt Tailwind](https://tailwindcss.nuxtjs.org/)
- [How to add class attribute to the body tag in NuxtJs](https://postsrc.com/code-snippets/how-to-add-class-attribute-to-the-body-tag-in-nuxtjs)
- [Nuxt i18n](https://v8.i18n.nuxtjs.org/)
- [How to Build a Multi-Language Application with NuxtJS](https://crowdin.com/blog/2023/01/24/nuxt-js-i18n-tutorial)
- [Vue i18n](https://vue-i18n.intlify.dev/)
- [Nuxt Seo Kit](https://github.com/harlan-zw/nuxt-seo-kit)
- [Nuxt Image](https://image.nuxtjs.org/)
- [Nuxt UI](https://ui.nuxt.com/)

<p align="right">(<a href="#readme-top">back to top</a>)</p>

<!-- MARKDOWN LINKS & IMAGES -->

[contributors-shield]: https://img.shields.io/github/contributors/data-miner00/nuxt-content-template.svg?style=for-the-badge
[contributors-url]: https://github.com/data-miner00/nuxt-content-template/graphs/contributors
[forks-shield]: https://img.shields.io/github/forks/data-miner00/nuxt-content-template.svg?style=for-the-badge
[forks-url]: https://github.com/data-miner00/nuxt-content-template/network/members
[stars-shield]: https://img.shields.io/github/stars/data-miner00/nuxt-content-template.svg?style=for-the-badge
[stars-url]: https://github.com/data-miner00/nuxt-content-template/stargazers
[issues-shield]: https://img.shields.io/github/issues/data-miner00/nuxt-content-template.svg?style=for-the-badge
[issues-url]: https://github.com/data-miner00/nuxt-content-template/issues
[license-shield]: https://img.shields.io/github/license/data-miner00/nuxt-content-template.svg?style=for-the-badge
[license-url]: https://github.com/data-miner00/nuxt-content-template/blob/master/LICENSE
反馈内容错误

看看同类模板

对比同技术栈与用途的模板，找到更适合的视觉与内容结构。

alpine-theme

alpine-theme

Alpine 是一个以极简为设计核心的博客主题，基于 Nuxt 与 Nuxt Content 构建。 它的特别之处在于，你可以从一个简单的个人资料页开始，逐步扩展成一个完整的博客。

Nuxt · 博客

bael-template

bael-template

Brutalist Blog theme for Netlify CMS

Nuxt · 博客

bloggrify

bloggrify

Run a blog from Markdown files. Themes, SEO, analytics, newsletter and comments preconfigured. Like Docus, but…

Nuxt · 博客

Nuxt_Mkdirs

Nuxt_Mkdirs

🚀 Open-source directory website template built with Nuxt 4 + Sanity CMS. 3 layouts, OAuth, payments, blog & m…

Nuxt · 博客

BlogiNote

BlogiNote

BlogiNote is a Nuxt Content Theme, it can generate static website to show your blog posts and notes with flexi…

Nuxt · 博客

nuxt3-microcms-blog

nuxt3-microcms-blog

A Nuxt3 blog template with microCMS + Vuetify3

Nuxt · 博客