博客快速参考手册

收藏这份快速参考手册，让博客操作更加得心应手！包含所有常用命令和操作的精简版指南。

🚀 快速命令

写作相关

# 新建文章
hexo new "文章标题"

# 新建草稿
hexo new draft "草稿标题"

# 发布草稿
hexo publish draft "草稿标题"

# 新建页面
hexo new page "页面名称"

预览发布

# 本地预览
hexo clean; hexo s

# 生成并部署
hexo clean; hexo g -d

# 包含草稿预览
hexo s --draft

📝 Front Matter 模板

---
title: 文章标题
date: 2024-01-16 10:00:00
updated: 2024-01-16 10:00:00
categories:
  - 分类1
  - 分类2
tags:
  - 标签1
  - 标签2
description: 文章描述（SEO用）
cover: https://example.com/cover.jpg
toc: true
comments: true
---

🎨 Markdown 速查

标题

# 一级标题
## 二级标题
### 三级标题

强调

**粗体文本**
*斜体文本*
~~删除线~~
`行内代码`

列表

- 无序列表项
- 无序列表项

1. 有序列表项
2. 有序列表项

- [x] 已完成任务
- [ ] 待完成任务

链接和图片

[链接文本](https://example.com)
![图片描述](https://example.com/image.jpg)

代码块

```javascript
console.log('Hello World');
```

表格

| 列1 | 列2 | 列3 |
|-----|-----|-----|
| 值1 | 值2 | 值3 |

引用

> 这是一段引用

📁 目录结构

myblog/
├── _config.yml          # 站点配置
├── package.json         # 依赖配置
├── scaffolds/           # 模板文件夹
│   ├── post.md         # 文章模板
│   ├── page.md         # 页面模板
│   └── draft.md        # 草稿模板
├── source/             # 源文件
│   ├── _posts/         # 文章
│   └── _drafts/        # 草稿
└── themes/             # 主题文件夹

⚙️ 常用配置

站点配置 (_config.yml)

# 网站信息
title: 网站标题
author: 作者名
language: zh-CN

# URL
url: https://yourdomain.com
permalink: :year/:month/:day/:title/

# 主题
theme: particlex

# 部署
deploy:
  type: git
  repo: git仓库地址
  branch: main

主题配置

主题配置文件：themes/particlex/_config.yml

🔧 故障排除

常见问题

1. 部署失败

   hexo clean
   rm -rf .deploy_git
   hexo deploy
   

2. 本地预览404

   hexo clean
   hexo g
   hexo s
   

3. 修改不生效

   • 清理缓存：hexo clean
   • 重启服务：Ctrl+C 后重新 hexo s

💡 小技巧

1. 批量操作

   • 使用 VS Code 的全局搜索替换
   • 使用脚本批量修改 Front Matter

2. 效率提升

   • 创建常用代码片段
   • 使用 Markdown 编辑器插件
   • 设置命令别名

3. 内容管理

   • 定期备份 source 文件夹
   • 使用 Git 管理版本
   • 保持分类和标签的一致性

📌 常用资源

• Hexo 官方文档
• Markdown 语法
• Unsplash 免费图片
• Shields.io 徽章

💡 提示：将此页面加入书签，方便随时查阅！