怎么发一篇文章
给麓叙小伙伴的投稿说明:从新建文件到推送上线,全流程一分钟走完。
麓叙的文章全部以 Markdown 文件形式放在 src/content/posts/ 目录下。发布一篇文章,本质上就是新建一个文件。
第一步:新建文件
在 src/content/posts/ 下创建 我的文章标题.md。文件名会成为网址的一部分,建议用简短的英文或拼音,比如 campus-spring.md。
第二步:填写文件头
每篇文章开头都要有一段 YAML 格式的元信息,叫做 frontmatter:
---
title: 文章标题
description: 一两句话的摘要,会显示在列表页
pubDate: 2026-09-04
author: 作者名
category: 栏目名
tags: ['标签1', '标签2']
draft: false
---
字段说明:
| 字段 | 必填 | 说明 |
|---|---|---|
title |
是 | 文章标题 |
pubDate |
是 | 发布日期,格式 YYYY-MM-DD |
description |
否 | 摘要,列表页会显示 |
author |
否 | 缺省用「麓叙编辑部」 |
category |
否 | 栏目,缺省「未分类」 |
tags |
否 | 标签数组 |
cover |
否 | 封面图 |
pinned |
否 | 是否置顶 |
draft |
否 | true 时线上不展示,但本地能预览 |
第三步:写正文
frontmatter 之后就是正文,用标准 Markdown 写就行:
- 标题用
###### - 加粗用
**文字**,斜体用*文字* - 链接用
[文字](网址) - 引用段落用
> 开头
第四步:本地预览
npm run dev
打开 http://localhost:4321 就能看到效果,边写边刷新。
第五步:上线
内容确认后推送到 GitHub(或直接让本地执行 npm run deploy),网站会自动更新。