第一篇博客
· 4 min read
这是我的第一篇博客,记录一下我的学习和生活。
本网站基于Docusaurus构建,使用了Markdown语法。
Docusaurus 是一款基于 React 的静态网站生成工具,专注于快速构建文档、博客等内容驱动型网站。以下是其核心使用方法和实践要点:
一、快速入门
-
安装与初始化
使用 Node.js 的npx
命令创建项目:npx create-docusaurus@latest my-website classic
该命令会生成经典模板项目,支持文档、博客和自定义页面。
-
启动开发服务器
cd my-website
npm start访问
http://localhost:3000
即可预览本地站点,支持实时热更新。 -
目录结构
项目主要目录包括:docs/
:存放文档(Markdown/MDX 文件)blog/
:存放博客文章src/
:自定义 React 组件和页面static/
:静态资源(如图片、CSS)
二、核心功能
- 文档与博客管理
- 文档编写:在
docs/
下创建.md
或.mdx
文件,通过sidebar_position
控制侧边栏排序。 - 博客发布:在
blog/
下按日期命名文件(如2025-03-30-intro.md
),支持标签、作者和摘要截断(通过 `
- 文档编写:在