欢迎来到 NaJimBlog 示例文章

本文是 NaJimBlog 的默认示例，帮助快速了解如何使用本系统。系统已开源，请移步查看https://github.com/NaJimmm/NaJimBlog#

项目简介

NaJimBlog 是一款轻量级、开源的内容管理系统，基于 Astro 构建，天然支持 Markdown、组件化布局与静态生成，纯前端编写，写作与部署都非常简单。

快速开始

1. 克隆仓库

   git clone https://github.com/NaJimzzzzzz/NaJimBlog.git
   cd NaJimBlog

2. 安装依赖

   npm install

3. 本地启动

   npm run dev

   浏览器访问 http://localhost:4321 即可实时预览。

4. 新建文章
   在 src/content/blog/ 目录下新建 .md 文件，Frontmatter 模板如下：

   ---
   title: 文章标题
   description: 一句话描述
   createdAt: 2025-12-25
   updatedAt: 2025-12-25
   categories:
     - 示例分类
   author: 你的昵称
   image: "@assets/demo.png"
   tags:
     - 示例标签
   draft: false
   hideToc: false
   ---

5. 撰写正文
   使用标准 Markdown 语法，支持：

   • 代码高亮
   • 数学公式（KaTeX）
   • Mermaid 流程图
   • 自定义组件（<Image />、<Video /> 等）

6. 构建与部署

   npm run build

   生成的 dist/ 目录可直接上传至任意静态托管平台（Vercel、Netlify、GitHub Pages…）。

特色功能

• 📝 容管理：博客、笔记、页面、友链、首页卡片
• 💬 评论系统：集成 Twikoo，支持多平台评论管理
• 🔍 全文搜索：基于 Astro 内容构建的本地搜索
• 🌓 深色/浅色模式：可切换深色或浅色模式
• 📱 响应式设计：适配桌面、平板、手机多端
• ⚡ 高性能：静态生成 + 边缘缓存，首屏极速加载

未来更新

• 👥 友链系统：未来会持续更新友链系统相关功能
• 🌍 地区系统：未来会持续更新地区系统相关功能

结语

作为个人博客，一定是追求“够用、好用、轻量”的理念，让创作者把精力放回内容本身，而不是复杂的代码编写。如果你觉得项目有帮助，欢迎 Star ⭐ 与分享！

---

最后更新：2025-12-25