写你的第一篇文章

站点跑起来了，现在来写第一篇属于你自己的文章吧！

理解文件结构

FlowPage 的文章都放在 content/pages/ 文件夹里，按年月组织：

content/pages/
  └── 2025/
      └── 10/
          └── my-first-post/    ← 这是文章的名字
              └── index.mdx      ← 这是文章内容

URL 就是：你的域名/2025/10/my-first-post

创建文章文件夹

在 content/pages/2025/10/ 下创建一个新文件夹，比如叫 my-first-post。

💡 文件夹名就是 URL，建议用英文，用 - 连接单词。

创建内容文件

在 my-first-post 文件夹里，创建 index.mdx 文件。

填写文章信息

在文件开头，用 --- 包裹文章信息：

---
title: "我的第一篇文章"
description: "这是我用 FlowPage 写的第一篇内容"
date: "2025-10-15"
author: "alice"
topics: ["life"]
tags: ["first", "test"]
category: "getting-started"
draft: false
---

字段说明

• title：文章标题（必填）
• description：简短描述（必填，会显示在分享链接预览）
• date：发布日期（必填，格式 YYYY-MM-DD）
• author：作者 ID（必填，就是你在 content/authors/ 里创建的）
• tags：标签数组，用来自动推荐相关文章
• category：分类
• draft：是否是草稿（true = 不发布）

写正文内容

在信息后面，开始写正文。用 ## 分段，每个 ## 就是一屏：

# 我的第一篇文章

这是开头部分，简单介绍一下这篇文章要说什么。

## 第一个要点

每个 `##` 标题会自动变成一个独立的屏幕块。

在手机上上下滑动，就能切换不同的内容块。

## 第二个要点

你可以用 Markdown 语法：

- 列表项 1
- 列表项 2

**加粗文字** 或 *斜体文字*

## 添加图片

![图片描述](./my-image.jpg)

把图片放在文章文件夹里，用相对路径引用。

## 总结

写完了！上下滑动看看效果吧。

保存并查看

1. 保存文件
2. 浏览器会自动刷新
3. 访问 http://localhost:4321/2025/10/my-first-post

在手机上打开，体验上下滑动切换内容块的感觉！

添加封面图（可选）

在文章文件夹放一张 cover.jpg，然后在文章信息里加：

cover: "./cover.jpg"

封面图会显示在文章列表和分享预览里。

小贴士

• 每个 ## 的内容不要太长，一屏能看完最好
• 图片文件名用英文，避免中文
• draft: true 可以先写草稿，不发布

下一步，学习如何让文章互相关联推荐！