大版本更新
一口气全面统一博客样式,移除部分冗余导航页面,更专注内容展示。
不因虚度年华而悔恨,不因碌碌无为而羞愧
博客系列第4期。教你做 Cloudflare IP 优选加速国内访问,以及 Astro 博客的 Markdown 文章编写规范。

Cloudflare 的默认节点对国内访问不太友好,有时候打开很慢。IP 优选的原理是找到一个国内延迟最低的 Cloudflare 节点,把你的域名解析到这个节点上,访问速度会有明显提升。
做完之后体感差别很大,建议部署好博客之后就做这一步。
你的域名/*(比如 blog.example.com/*)这条规则的作用是让博客的所有页面和静态资源都走优选节点。
speed任意内容.cf.090227.xyz)blog,根域名就填 @)speed.你的域名.com)刷新博客试试,应该能感觉到速度提升。
原理简述:博客域名 -> 优选地址 -> Cloudflare 自动选最快的国内节点。Astro 生成的都是纯静态文件(HTML/CSS/图片),配合 CDN 加速效果很好。
博客部署好了,接下来就是写文章。Firefly 用 Markdown(.md)或 MDX(.mdx)格式,功能很丰富。
所有文章放在 src/content/posts/ 目录下,可以建子目录来组织。图片等资源放在同目录或 src/assets/ 下。文件名建议用英文连字符格式(如 cloudflare-ip-optimize.md),避免中文路径问题。
每篇文章顶部用 --- 包裹 YAML 元数据:
1---2title: "文章标题" # 必填3published: 2026-05-03 # 必填,发布日期4updated: 2026-05-04 # 可选,更新日期5description: "文章简介" # 可选,首页卡片显示6image: # 可选,封面图(相对路径/网络链接/随机图API都行)7tags:8 - 标签19 - 标签210category: 分类名 # 可选11draft: false # true 则隐藏不显示12pinned: false # true 则置顶13slug: my-custom-url # 可选,自定义URL路径14author: 作者名 # 可选15comment: true # 可选,是否开启评论16---各字段说明:
| 字段 | 必填 | 说明 |
|---|---|---|
title | 是 | 文章标题 |
published | 是 | 发布日期,格式 YYYY-MM-DD |
updated | 否 | 更新日期 |
description | 否 | 首页卡片显示的简介 |
image | 否 | 封面图,支持相对路径、绝对路径、网络链接、随机图 API |
tags | 否 | 标签列表 |
category | 否 | 分类 |
draft | 否 | true 为草稿不显示,false 正式发布 |
pinned | 否 | true 置顶显示 |
slug | 否 | 自定义 URL 路径,建议英文连字符 |
author | 否 | 作者名 |
comment | 否 | 是否开启评论,默认 true |
licenseName | 否 | 许可证名称(如 CC BY-NC-SA 4.0) |
password | 否 | 文章密码,设置后需输入密码才能查看 |
主题内置 KaTeX,直接用就行。
行内公式用单 $:$E = mc^2$
块级公式用双 $$:
1$$2\sum_{i=1}^{n} i = \frac{n(n+1)}{2}3$$用 mermaid 代码块即可渲染各种图表:
1```mermaid2graph TD3 A[开始] --> B{条件}4 B -->|是| C[执行]5 B -->|否| D[结束]6```还支持时序图、甘特图、饼图、类图、状态图等。
用 GitHub 风格的语法,很直观:
1> [!NOTE]2> 普通提示3
4> [!TIP]5> 小技巧6
7> [!WARNING]8> 注意9
10> [!CAUTION]11> 危险操作直接粘贴 iframe:
1<iframe src="//player.bilibili.com/player.html?bvid=BV1xxxxx"2 scrolling="no" border="0" frameborder="no"3 framespacing="0" allowfullscreen="true">4</iframe>1::github{repo="CuteLeaf/Firefly"}两个推荐:
文章写好后:
1git add .2git commit -m "新增文章:xxx"3git push推到 GitHub 后 Cloudflare 自动构建上线,刷新博客就能看到了。
官方文档:docs-firefly.cuteleaf.cn/zh/guide/writing
视频链接:BV1Hk9fBTE6H
生成精美分享图或复制链接,与更多人分享本文。
最后更新于 ,距今已过 170 天
部分内容可能已过时