写作技巧
写作技巧
掌握 Hexo 写作技巧，让你的博客文章更专业、更易读。
文章结构
Front Matter
每篇文章顶部的 YAML 区域，用于配置文章元信息：
1
2
3
4
5
6
7
8
9
10
11
| ---
title: 文章标题
date: 2024-01-01 10:00:00
categories:
- 技术
tags:
- Hexo
- 教程
cover: /images/cover.jpg
description: 文章简介，用于 SEO 和摘要
---
|
常用 Front Matter 字段
| 字段 | 说明 | 示例 |
|---|
title | 标题 | 我的文章 |
date | 日期 | 2024-01-01 10:00:00 |
updated | 更新日期 | 2024-01-02 10:00:00 |
categories | 分类 | [技术] |
tags | 标签 | [Hexo, 教程] |
cover | 封面图 | /images/cover.jpg |
description | 描述 | 文章简介 |
published | 是否发布 | true / false |
comments | 是否开启评论 | true / false |
Markdown 基础
标题
1
2
3
4
| # 一级标题
## 二级标题
### 三级标题
#### 四级标题
|
文本格式
1
2
3
4
| **粗体文本**
*斜体文本*
~~删除线~~
`行内代码`
|
列表
1
2
3
4
5
6
| - 无序列表项 1
- 无序列表项 2
- 子项
1. 有序列表项 1
2. 有序列表项 2
|
链接和图片
1
2
| [链接文字](https://example.com)
|
代码块
1
2
3
4
5
| ```javascript
function hello() {
console.log('Hello, World!');
}
```
|
引用
表格
1
2
3
| | 列1 | 列2 | 列3 |
|-----|-----|-----|
| 数据1 | 数据2 | 数据3 |
|
Stellar 标签插件
提示框
1
2
3
| {% note color:blue 提示 %}
这是一条蓝色提示信息。
{% endnote %}
|
可用颜色：blue、green、red、orange、yellow、purple、light、dark
图片
1
| {% image /images/photo.jpg alt:"图片描述" width:80% %}
|
标签页
1
2
3
4
5
6
| {% tabs active:1 %}
<!-- tab 标签一 -->
内容一
<!-- tab 标签二 -->
内容二
{% endtabs %}
|
时间线
1
2
3
4
5
6
| {% timeline %}
<!-- node 2024.1.1 -->
事件一
<!-- node 2024.1.2 -->
事件二
{% endtimeline %}
|
折叠面板
1
2
3
| {% folding open:false 点击展开 %}
隐藏的内容
{% endfolding %}
|
写作建议
内容规划
- 每篇文章聚焦一个主题
- 使用小标题组织内容结构
- 代码示例要完整可运行
- 配图辅助说明复杂概念
文章长度
- 教程类：1000-3000 字
- 技术笔记：500-1500 字
- 深度分析：3000+ 字
发布频率
- 保持稳定的更新节奏
- 质量优先于数量
- 可以先写草稿，积累后发布
草稿管理
创建草稿：
草稿存放在 source/_drafts/ 目录，不会被发布。
预览草稿：
发布草稿：
这会将草稿移动到 source/_posts/ 目录。
💡 提示：好的写作习惯比任何优化技巧都重要。坚持记录，持续输出，你的博客会越来越好。