怎么发一篇文章

给麓叙小伙伴的投稿说明:从新建文件到推送上线,全流程一分钟走完。

返回列表

麓叙的文章全部以 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),网站会自动更新。