先说结论#

如果你只想马上用起来，直接照这个写：

1
---
2
title: 你的文章标题
3
published: 2026-04-20
4
description: 一句话简介
5
tags: [学习笔记]
6
category: 博客搭建
7
author: Coldairboy
8
image: ./images/firefly1.avif
9
pinned: true
10
---

保存后刷新页面，这篇文章就会优先显示。

这个项目为什么确定支持置顶#

我已经帮你查过代码了，结论很明确：

1. 文章数据模型里已经定义了 pinned 字段
2. 文章排序逻辑会先判断 pinned
3. 页面上还会显示“置顶”标记

也就是说，这不是“可能支持”，而是已经做好的功能。

正确用法#

1
src/content/posts/

1
src/content/posts/21.md

1
---
2
title: 21. B站视频嵌入指南
3
published: 2026-04-19
4
description: 博客B站视频嵌入教程
5
tags: [博客配置]
6
category: 博客搭建
7
author: Coldairboy
8
image: ./images/firefly1.avif
9
pinned: true
10
---

1
cd E:\GITHUB\firefly-replica
2
pnpm dev

1
cd E:\GITHUB\firefly-replica
2
.\publish-blog.bat

取消置顶怎么做#

有两种方式都可以：

1
pinned: true

1
pinned: false

置顶后的实际效果#

这个项目的逻辑是：

1. 先看文章是不是置顶
2. 置顶文章排在前面
3. 如果都是置顶，或者都不是置顶，再按发布日期排序

所以你可以理解成：

• pinned: true 的文章，会优先排到前面
• 普通文章，再按日期新旧排序

页面上会怎么显示#

置顶文章通常会有两种变化：

1. 在文章列表里排得更靠前
2. 在文章信息区域显示“置顶”标记

所以如果你看到文章顺序变了，同时页面上还有“置顶”字样，说明功能已经正常生效。

新手最常见的错误#

1
pinned: true

1
sticky: true

1
src/content/posts/

最适合你的使用方式#

如果你现在只是想让一篇重点文章长期挂在最前面，最简单的做法就是：

1. 打开那篇文章
2. 在头信息里加 pinned: true
3. 本地预览确认
4. 推送到 GitHub

就这么简单。

推荐场景#

下面这些文章很适合置顶：

• 自我介绍
• 博客导航
• 新手入门说明
• 最重要的一篇教程
• 你的代表作文章

不建议滥用#

如果你很多文章都设置成置顶，会出现两个问题：

1. 首页前面全是置顶，看起来会很乱
2. 新文章会被压到后面，不容易被看到

比较稳的做法是只保留 1 到 3 篇置顶文章。

一份可直接复制的模板#

1
---
2
title: 文章标题
3
published: 2026-04-20
4
description: 一句话简介
5
tags: [学习笔记]
6
category: 博客搭建
7
author: Coldairboy
8
image: ./images/firefly1.avif
9
pinned: true
10
---

最后总结#

这个项目有原生文章置顶功能，而且用法非常简单。

你只需要记住一句话：

1
pinned: true

写上它，就是置顶。删掉它，或者改成 false，就是取消置顶。