Markdown 写作指南：语法速查

新建文章#

双击项目根目录的 新建文章.bat，输入英文文件名后会自动生成模板并用编辑器打开。

文章都在 firefly/src/content/posts/ 目录下，图片放同级的 images/ 文件夹。

前置参数（Front-matter）#

每篇文章开头的 --- 包裹区域叫 front-matter，用来声明元信息：

1
---
2
title: 文章标题
3
published: 2026-10-19
4
description: 一句话简介（显示在列表卡片里）
5
image: ./images/cover.png
6
tags: [标签1, 标签2]
7
category: 分类
8
pinned: false    # 设为 true 置顶
9
---

常用语法#

1
[链接文字](https://example.com)
2
![图片说明](./images/photo.jpg)

1
function greet(name) {
2
  console.log(`Hello, ${name}!`);
3
}

主题扩展语法#

Firefly 在标准 Markdown 之上加了一些好用的指令：

1
> [!NOTE]
2
> 提示内容
3

4
> [!WARNING]
5
> 警告内容

1
::github{repo="CuteLeaf/Firefly"}

发布#

写完保存，双击 发布.bat，构建完成后自动上传到 Cloudflare Pages。