怎样在网页直接创建文章

概述

本网站采用基于文件的内容管理系统，您只需要将 Markdown 文件提交到代码仓库，文章就会自动出现在资讯动态列表中。这种方式既简单又高效，特别适合团队协作和版本管理。

Markdown 文件结构

文章使用 Markdown 作为标记语言进行编写。每个文章文件都由两个主要部分组成：

1. Front Matter（元数据）

位于文件开头，用三个短横线 --- 包围，包含文章的配置信息：

• publishDate: 发布日期
• title: 文章标题（必填）
• excerpt: 文章摘要
• category: 分类
• tags: 标签
• image: 标题图片

2. 正文内容

使用 Markdown 语法编写的文章正文内容。

💡 提示：文件名将作为文章的 URL 路径，建议使用有意义的中文或英文名称。

操作步骤

第一步：进入文章存储目录

打开仓库的 src/data/post 文件夹, 这里是所有文章文件的存储位置

第二步：创建新文件

1. 点击页面右上角的 新建文件
2. 输入文件名，必须以 .md 结尾（例如：测试文章.md）

第三步：编写文章内容

1. 在编辑器中首先添加 Front Matter 配置信息
2. 修改标题、分类等信息
3. 在配置信息下方编写正文内容

配置示例：

---
publishDate: 2025-08-07T00:00:00.000Z
title: 测试文章
excerpt: 这是一篇测试文章
category: 测试
tags:
  - 示例
  - 教程
---

这里是文章正文内容...

后续, 我们会用本地编辑器的面板配置这些信息, 所以走下流程就行了, 不需要记字段名称和格式.

第四步：提交文件

1. 完成编辑后，点击底部的 “提交” 按钮
2. 在提交信息框中输入有意义的提交说明（或者使用默认信息）
3. 点击 “立即提交”

第五步：查看构建状态

1. 切换到 流水线页面
2. 可以看到由提交触发的新构建任务
3. 等待构建完成（大概 1 分钟）

第六步：验证文章发布

构建完成后，访问 测试官网博客页面，新文章应该已经出现在文章列表中。

注意事项

• 文件名建议使用英文或拼音，避免特殊字符
• Front Matter 中的冒号必须使用英文冒号（:）
• 标题（title）字段是必填项，其他字段可选
• 提交后需要等待构建完成才能在网站上看到更新