FreeCat Blog

Freecat Blog 免费博客构建指南 | 本地写作 + GitHub 备份 + 免费部署

2026-05-15T00:00:00.000Z

Freecat Blog 是一套面向新手的个人博客模板。本地写 Markdown，把改动同步到 GitHub，Cloudflare Pages 或 Vercel 会自动发布成网站。

GitHub 地址：https://github.com/OUBIGFA/Freecat-Blog

演示网站：演示站点 01 | 演示站点 02

为什么选择 Freecat Blog

数据在自己手上

文章原稿保存在你的电脑和 GitHub 仓库里
即使云端部署或平台服务出错，也不会失去文字的所有权
不被单个平台锁住，随时可以备份、迁移或重新发布

功能强大

博文可自由置顶、隐藏
支持自定义一个或多个标签
Markdown 支持渲染数学公式、图表、流程图、序列图、甘特图等
支持音频、视频播放
支持常规网站的外部嵌入展示
超长代码块自动折叠，内置回到顶部/底部和展开/折叠的跟随控制器
少即是多——去除所有多余动效与视觉干扰，无打扰的阅读体验，一切为了可阅读性

对新手友好

可选择完全不写元数据，直接写正文即可
通过 Markdown 元数据和控制文件里的简单填写或勾选，就能直观定制网站外观、资料、社交链接、置顶和显示状态，告别复杂后台和代码
支持 .md、.txt 等多种格式
不需要考虑排版，纯文字也可以

排版自动优化

自动优化中英混排间距
专注内容写作，系统自动处理格式

提示： 如遇构建相关问题，只需前往主仓库复制最新的 sync-upstream 或 update-git-dates.yml 工作流文件到你的仓库并手动运行一次。该工作流仅同步构建文件，不会覆盖你的自定义设置和 writing/ 写作文件夹。如需使用新增功能，请从主仓库 Control 文件夹复制对应控制参数到你仓库的 Control/ 文件夹。

不需要服务器，不需要编程基础。日常只要记住三个文件夹。

文件夹	功能	说明
`writing/`	写文章	一篇 Markdown 文件就是一篇博客文章
`Control/`	改网站信息	改网站名、头像、首页介绍、社交链接、About 页面
`all/`	构建资源	部署平台从这里构建网站

写文章去 writing/，个性化去 Control/，部署构建根目录填 all。

Freecat Blog 也内置了搜索优化支持：可生成 Sitemap、RSS、llms.txt，并配有 Google、Bing 收录提交教程。需要设置正式域名、SEO 摘要、作者信息或 AI 爬虫策略时，直接看 Control/SEO_搜索优化 .md。

把网站交给 Google 和 Bing —— 小白零基础教程

最短部署路径预览

用 GitHub Importer 导入并转换成私人博客仓库
去 Cloudflare Pages 或 Vercel 导入仓库构建
等部署完成，打开默认网址确认

最短使用路径预览

用 GitHub Desktop 拉到本地
本地打开项目，在 writing 文件夹中撰写或存入一篇文章（文章元数据非必需）
通过 GitHub Desktop 提交并同步到 GitHub
等待平台自动部署构建
完成

就三件事

所有内容存在本地，换平台不丢数据。
GitHub 管备份，同时通知部署平台更新。
部署平台只负责把仓库渲染成网站。

新手怎么挑部署平台

首选：Cloudflare Pages

适合绝大多数个人博客。

免费
稳定
配置清晰
静态网站托管成熟
绑自定义域名方便

备选：Vercel

已经有 Vercel 账号、或者习惯用 Vercel 的，也可以直接选它。

上手快
界面清爽
和 GitHub 联动顺
个人博客完全够用

完全新手选 Cloudflare Pages；已经在用 Vercel 的，选 Vercel。两个平台以后想换都容易，内容都在本地和 GitHub 上。

动手前准备这些

项目	是否必需	说明
GitHub 账户	必需	用于保存你的博客仓库
GitHub Desktop	必需	本地同步工具，下载地址
Markdown 编辑器	必需	写文章和改配置，推荐 Obsidian
Cloudflare 账户	推荐	用于自动构建和发布网站
Vercel 账户	可选	另一种自动部署方式

第一步：建一个自己的博客仓库

1. 登录 GitHub

打开 https://github.com/
登录账号
没有账号就先注册一个

2. 打开 Importer 页面

浏览器访问 https://github.com/new/import

3. 填写导入表单

字段	应填写的值
`Your old repository's clone URL`	`https://github.com/OUBIGFA/Freecat-Blog`
`Owner`	选你自己的 GitHub 账户
`Repository name`	起一个名字，比如 `my-freecat-blog`
`Privacy`	选 `Private`

4. 开始导入

点页面底部的 Begin import
等导入完成，一般几十秒到几分钟
看到 Your new repository ... is ready 就成功了
点进新仓库，确认能看到 all/、Control/、writing/ 等文件夹

5. 下载到本地

装好并登录 GitHub Desktop
点 File → Clone repository
选刚导入好的仓库
选一个好找的本地位置
点 Clone

到这一步，电脑里就有完整的 Freecat Blog 项目了。

第二步：部署参数速查表

两个平台的填法不一样，别照搬。

Cloudflare Pages：按下表手动填写构建参数。
Vercel：只需要把 Root Directory 选成 all 文件夹，其余全部保持默认（详见方案二）。

项目（Cloudflare Pages）	应该填写什么
仓库	你自己的 GitHub 仓库
根目录 / Root Directory / Base Directory	`all`
构建命令 / Build Command	`npm run build`
构建输出目录 / Output Directory / Publish Directory	`dist`
环境变量 / Environment Variable	`NODE_VERSION=20`

最容易错的是输出目录。正确写 dist，不要写 all/dist，因为根目录已经切到 all，输出目录要按它里面的相对路径写。

把 NODE_VERSION 显式设为 20，免得受平台默认 Node 版本变动影响。

方案一：部署到 Cloudflare Pages

第 1 步：进入 Cloudflare Pages

登录 Cloudflare Dashboard
点「创建应用程序」

选「Pages」

选「导入现有 Git 储存库」

选你自己的博客仓库

第 2 步：填写构建配置

项目名称随意起，关键参数按下表填。

Cloudflare 界面中文	Cloudflare UI English	应填写的值
框架预设	Framework preset	`无 / None`，或不选预设
根目录（高级）	Root directory (advanced) > Path	`all`
构建命令	Build command	`npm run build`
构建输出目录	Build output directory	`dist`
环境变量（选填）	Environment variables	`NODE_VERSION` = `20`

填好点 Save and Deploy，等构建跑完。一般 1-3 分钟。

建议在 Cloudflare Pages 项目设置里启用 Build cache（构建缓存）。字体子集工具链完全走 npm 依赖，依赖缓存命中后安装只需几秒；仓库自带的字体子集能覆盖已知文章字符时会直接复用，文章新增字符后也只需几秒到几十秒就能在构建中增量扩充字体集，无需 Python 环境。

第 3 步：访问默认网址

构建完成后，Cloudflare 会给你一个 xxx.pages.dev 形式的默认网址。打开能看到博客页面，就说明部署成功。

第 4 步：以后怎么更新网站

之后不用手动上传文件，按这个流程走。

本地写文章或改配置
用 GitHub Desktop 提交并同步到 GitHub
Cloudflare 自动重新构建
网站自动更新

第 5 步：绑定自己的域名

想用自己的网址，在 Cloudflare Pages 项目里绑定自定义域名，按平台提示改 DNS 解析就行。

可以参考：

Cloudflare Pages 常见坑

坑 1：根目录没填 `all`

项目实际在 all/ 里。不填的话，平台会从仓库根目录找 package.json，多半构建失败。

坑 2：输出目录填成 `all/dist`

根目录已经是 all，输出目录直接写 dist 就行，不用再带前缀。

坑 3：随便选了框架预设

这个项目不属于 Next.js、Nuxt、Astro 这类框架，预设选 None / 无 最稳。

坑 4：网站没更新就以为失败

先看 Cloudflare 后台最新那次构建有没有成功，再 Ctrl + F5 强刷一下。很多时候只是浏览器缓存。

方案二：部署到 Vercel

习惯用 Vercel 的，按这个流程来。

第 1 步：导入 GitHub 仓库

登录 Vercel
点 Add New...
选 Project
连接 GitHub
授权 Vercel 访问你的仓库
选你自己的博客仓库

第 2 步：把 Root Directory 选成 all 文件夹

Vercel 只需要改这一处，其余设置全部保持默认，不要手动填构建命令或输出目录。

在导入页面找到 Root Directory，点右侧的 Edit

Vercel 导入页面点 Root Directory 的 Edit

在弹窗里勾选 all 文件夹，点 Continue

在弹窗中勾选 all 文件夹

构建命令、输出目录和页面地址规则，由仓库自带的 all/vercel.json 自动接管，所以都不用填。

最容易踩的坑：Root Directory 没选 all，或者展开 Build and Output Settings 手动覆盖了构建设置。这两种情况都会让 Vercel 读不到 all/vercel.json，部署出来的网站页面会全部 404。

Vercel 会自动恢复构建缓存。Freecat Blog 会复用其中的字体子集缓存；文章没有新增字符时，后续部署会跳过字体生成；即使删除文章，已经生成过的字符也会继续保留。除非你确实想强制重新生成，否则不要在项目设置里主动清空 Build Cache。

第 3 步：部署并访问

点 Deploy
等 Vercel 构建完成，一般 1-3 分钟
成功后打开 Vercel 给的默认网址

第 4 步：绑定自己的域名

进项目设置里的 Domains，加上自己的域名，按 Vercel 提示改解析。

第三步：开始写文章

writing/ 是日常用得最多的文件夹，一个 .md 文件就是一篇文章。可以打开示例文章看格式、复制一篇当模板、新建自己的 .md，不要的示例直接删掉。

一篇文章通常长这样。

md
 
---
title: 我的第一篇文章
date: 2026-05-03
tag:
  - 随笔
cover:
show_image_captions: true
description: 这里写文章摘要
pinned: false
show: true
copy_content: false
---

这里开始写正文。

常用字段：

字段	作用
`title`	文章标题，留空时用文件名
`date`	发布或显示日期
`tag`	标签，可以写多个
`cover`	封面图片 URL，留空则没有封面
`show_image_captions`	是否显示图片下方说明文字
`description`	文章摘要，留空则自动截取
`pinned`	是否置顶
`show`	是否在网站上展示
`copy_content`	是否允许复制正文

第四步：个性化网站

Control/ 是网站控制台。想把模板改成自己的博客，主要就改这里。

文件	负责什么
`site_网站属性 .md`	网站标题、站点名、首页介绍、头像、主题
`SEO_搜索优化 .md`	正式域名、SEO 摘要、作者信息、AI 爬虫和 llms.txt
`social_社交媒体 .md`	社交媒体图标、主页链接、联系方式、推广链接
`about_关于页面 .md`	About 页面的标题、介绍和头像

编辑要点：

所有参数都写在文件顶部 --- 包起来的 Frontmatter 区块里
格式是 键: 值，冒号后留一个空格
留空字段保留 键: 即可，别删整行
_01、_02 这类是说明文字，构建时会忽略，别改名

`site_网站属性 .md`

常改的几项：网站名称、网站描述、首页标题、头像、网站图标、默认主题、每页显示文章数量、底部版权文字。

主题设置里，下面三个字段只能有一个为 true。

theme_system
theme_light
theme_dark

三个都为 false 时，会自动回退到跟随系统。别三个一起写 true。

`social_社交媒体 .md`

每个社交平台一般有三类字段。

字段类型	例子	作用
启用开关	`github_enabled: true`	`true` 显示，`false` 隐藏
自定义图标	`github_icon_url:`	留空走默认图标，也可填自己的图标 URL
主页链接	`github_url: https://github.com`	点图标后跳转到哪

用不到的平台，把对应的 *_enabled 改成 false。

`about_关于页面 .md`

常用字段。

字段	说明
`about_hero_title`	About 页面的标题，留空则用首页标题
`about_hero_subtitle`	About 页面的介绍，留空则用首页介绍
`about_hero_avatar`	About 页面的头像，留空则用首页头像

想让 About 和首页保持一致，这三个字段都留空即可。

日常更新流程

以后每次更新博客，照这个流程走。

在本地写文章或改配置
保存文件
打开 GitHub Desktop
写一句提交说明
点 Commit to main
点 Push origin
等部署平台自动更新
打开网站检查结果

这一套跑通，博客就能长期稳定用下去。

文章内音频、视频播放器

文章里可以直接放音频播放器和视频播放器。关键是：链接必须是“文件直链”，不是普通网盘分享页。

普通分享链接通常长这样：打开后先进入一个网盘页面，再点下载或播放。网站无法直接把这种页面变成播放器。

文件直链通常长这样：复制到浏览器地址栏后，会直接打开或下载这个音频、视频文件。网站需要的就是这种链接。

音频播放器

在文章里用图片格式 + 音频直链，会自动出现音频播放器。

code
 
![这是示例音频|112](https://xxx.xxx/example.m4a)

链接没有明显音频后缀的话，在标题里加个 🎵 强制识别。

code
 
![🎵这是示例音频|129](https://xxx.xxx/example)

支持的常见音频格式：.mp3、.m4a、.wav、.ogg、.aac、.flac、.opus。

视频播放器

在文章里用图片格式 + 视频直链，会自动出现视频播放器。

code
 
![这是示例视频|112](https://xxx.xxx/example.mp4)

链接没有明显视频后缀的话，在标题里加个 🎬 强制识别。

code
 
![🎬这是示例视频](https://xxx.xxx/example)

支持的常见视频格式：.mp4、.webm、.mov、.m4v、.ogv、.m3u8。

从网盘分享链接转换成直链

推荐先把音频、视频上传到网盘，再用直链工具把“分享链接”转换成文章里能直接使用的“文件直链”。

推荐工具：

最简单的操作流程：

把音频或视频上传到网盘。
在网盘里创建分享链接，并复制这个分享链接。
打开上面的直链工具，把分享链接粘贴进去。
点击解析、转换或获取直链。
复制工具生成的新链接。
把新链接放进文章里的音频或视频示例格式中。

例如，工具生成的是音频直链，就这样写：

code
 
![🎵I Still Believe](https://工具生成的音频直链)

工具生成的是视频直链，就这样写：

code
 
![🎬中餐是不是健康饮食？](https://工具生成的视频直链)

判断链接能不能用，有一个很直白的方法：把链接复制到浏览器地址栏里打开。如果浏览器直接播放、直接下载，或者页面只显示这个文件本身，一般就可以用。如果打开后还是网盘页面、登录页面、提取码页面、广告页，通常就不能直接当播放器链接用，需要重新转换。

注意：网盘直链可能会失效。如果以后文章里的播放器突然不能播放，先重新打开原分享链接检查文件是否还在，再用直链工具重新生成一次链接。

模板更新怎么同步过来

Freecat Blog 会持续更新模板工程，比如修 bug、加功能、优化样式。仓库里自带一个 GitHub Actions 工作流：.github/workflows/sync-upstream.yml。

每周二北京时间凌晨 02:17，它会自动从主仓库 OUBIGFA/Freecat-Blog 同步模板文件，提交到你的仓库。部署平台收到新提交后会自动重建网站。

同步范围：

会同步：all/、README.md、README.en.md
会保留：all/git-dates.json、all/build/font-subsets-manifest.json、all/src/assets/fonts/
不会动：Control/、writing/、.github/、.gitignore

也就是说，你写的文章和网站配置不会被模板更新覆盖。

想马上手动触发一次同步：

打开你的 GitHub 仓库
点顶部 Actions
左侧选 Sync upstream template files
右上角点 Run workflow
再点一次 Run workflow 确认

几个细节：

上游模板没变化时，工作流会跳过提交。
GitHub Actions 定时触发可能延迟几分钟，属正常现象。
改过 all/ 里的模板、样式或构建脚本的话，自动同步可能覆盖这些改动。新手通常别动 all/。

进阶：用 Obsidian 做本地写作中心

可以把这个博客仓库直接当成 Obsidian 仓库用。

推荐流程：

用 Obsidian 打开本地博客文件夹
在 writing/ 目录写文章
改完顺手检查文章头部属性
用 GitHub Desktop 同步
等平台自动部署

写完就同步，大改前也先同步一次，别让没保存的内容只留在某个临时软件里。这样内容更安全。

进阶：本地预览和构建

只是写文章和部署的话，不用本地构建，平台会自动处理。

想在本机提前预览网站，先装 Node.js 20+，再在项目里运行：

bash

cd all
npm install
npm run build

构建产物在 all/dist/。这是自动生成的目录，不用手动改，也不用提交到 GitHub。

进阶：先用好皮肤，再考虑改皮肤

这套博客可以理解成「一套博客皮肤 + 一套本地写作和自动发布工作流」。

对新手来说，先把部署跑通。能稳定写文章、形成更新节奏之后，再考虑改外观和功能。上线才有反馈，写了内容才知道缺什么，稳定用一段时间再改，比一上来折腾皮肤要稳。

进阶：怎么搭配 AI 一起用

Markdown 是纯文本，整理、改写、拆分都方便，适合配合 AI 工具用。

可以让 AI 帮你做这些事：

润色文章
生成标题
改写摘要
拆分长文结构
优化排版
想选题
做专题策划

建议先自己写出内容，再让 AI 整理、补强、压缩或扩展。这样文章更像你写的，不会一股模板味。

智能体软件参考：

用户体验拉满的智能体软件汇总

常见问题

我必须会编程吗

不用。只想写文章 + 部署，按这篇教程一步步来就够。

我必须先买域名吗

不用。Cloudflare Pages 和 Vercel 都会先给一个默认网址，以后想换自己的域名再说。

`.gitignore` 是什么，什么时候要用

.gitignore 是仓库根目录里的一个文件，可以把它理解成“不要同步到 GitHub 的文件清单”。

你本地可能会出现一些不适合上传的文件，比如：

临时草稿
测试日志
系统自动生成的文件
自己电脑上的私人配置

这些文件不属于网站内容，提交到 GitHub 反而容易让仓库变乱。把它们写进 .gitignore 后，GitHub Desktop 通常就不会再提示你提交它们。

比如你想忽略本地草稿文件夹、系统文件和日志文件，可以这样写：

gitignore

# 忽略本地草稿文件夹
drafts/

# 忽略系统自动生成的文件
.DS_Store
Thumbs.db

# 忽略临时日志
*.log

写法很简单：

忽略某个文件夹：写 文件夹名/，例如 drafts/
忽略某个具体文件：写完整文件名，例如 Thumbs.db
忽略某一类文件：用 * 表示任意名字，例如 *.log

新手最常见的做法是：在仓库根目录打开 .gitignore，把不想上传的新文件或新文件夹按上面的格式加进去，保存后再看 GitHub Desktop 的变化列表。

注意：.gitignore 只会忽略“还没有提交过”的新文件。如果某个文件已经提交到 GitHub，后来再写进 .gitignore，它不会自动从仓库里消失。

为什么我本地改完了，网站没变

按顺序检查：

文件有没有保存
GitHub Desktop 有没有提交
有没有同步到 GitHub
部署平台有没有开始自动构建
浏览器是不是缓存了旧页面

以后能从 Vercel 换到 Cloudflare Pages 吗

可以。文章和配置都在本地和 GitHub 上，换平台重新导入仓库就行。

我最容易填错什么

最常出错的就这两项：

Root Directory / Base Directory 没填 all
Output Directory / Publish Directory 错填成 all/dist

正确填法：

可以删除示例文章吗

可以。示例都在 writing/ 里，删掉后提交并同步即可。

可以直接改 `all/` 吗

新手不建议。all/ 是模板工程目录，自动同步上游模板时这里的改动可能被覆盖。日常写作和个性化主要在 writing/ 和 Control/ 里改。

把网站交给 Google 和 Bing —— 小白零基础教程

2026-06-03T00:00:00.000Z

下面两份教程会手把手带你把网站登记到 Google 和 Bing 两家搜索引擎，让别人能在搜索结果里找到你。

整篇示例用的网址都是 https://freecat-blog.pages.dev，你照着做的时候，把它换成你自己的网址即可。

准备工作：先确认你的网站能在浏览器里正常打开。例如把 https://freecat-blog.pages.dev 粘贴到浏览器地址栏，能看到你的博客首页，就可以开始了。

如果你用的是自己的域名，并且这个域名托管在 Cloudflare，请先到 Cloudflare 后台关闭或放行会拦截搜索引擎的反爬规则。重点检查 Bot Fight Mode、WAF 托管质询、Security Rules、AI Crawl Control / Managed robots 这类功能，至少要放行 Googlebot、Bingbot、/sitemap.xml 和 /robots.txt。否则浏览器里明明能打开网站，Google 或 Bing 仍可能读不到 Sitemap。

一、Google Search Console（让 Google 找到你）

第 1 步：打开官方网址，登录账号

打开浏览器，访问 https://search.google.com/search-console

页面会跳到登录界面，用你的 Google 账号（也就是 Gmail 邮箱）登录。
- 如果没有 Google 账号，点登录框下面的"创建账号"先注册一个或查看 Gmail 注册指南。
登录成功后，会看到一个写着"欢迎使用 Search Console"的页面，中间有一个"开始"按钮，点它。

第 2 步：添加你的网站

进入主界面后，会出现"选择资源类型"的弹窗，里面有两个方框：
- 左边：网域（Domain）
- 右边：网址前缀（URL prefix）
请选右边的"网址前缀"（小白用这个最简单，不用碰 DNS 设置）。
在输入框里，完整粘贴 你的网址，包含 https://：
code
```
https://freecat-blog.pages.dev
```
点下方的"继续"按钮。

第 3 步：验证你是网站的主人

Google 会让你证明这个网站是你的。会弹出几种"验证方法"，推荐选第一种"HTML 标记"（HTML tag）。

在弹窗里找到"HTML 标记"那一行，点开它。
你会看到一段类似下面的代码（你的实际内容会不一样，不要直接抄这段，要复制你自己页面上的那一段）：
html
```
<meta name="google-site-verification" content="abc123XXXXXXXXXXXXXXXXXXXXXXXXXXX" />
```
点这段代码右侧的"复制"按钮，先放在一边。
暂时不要关这个 Google 页面，先去网站项目里粘贴这段代码。

第 4 步：把验证代码贴到网站里

打开本项目里的这个文件：

code

Control/SEO_搜索优化.md

在文件里找到 google_html_marker: 这一行，把你刚才复制的整段 HTML 标记粘贴到冒号后面。粘贴完应该长这样（中间的 content 内容是你自己复制的，不是示例）：

yaml
 
google_html_marker: <meta name="google-site-verification" content="abc123XXXXXXXXXXXXXXXXXXXXXXXXXXX" />

保存文件。

第 5 步：把改动发布到线上

把项目里的改动提交（commit）并推送（push）到 GitHub。
Cloudflare Pages 会自动重新构建网站，大约 1～2 分钟后线上就更新好了。
你可以在浏览器里打开 https://freecat-blog.pages.dev，按 Ctrl + U 查看网页源代码，搜索 google-site-verification，能搜到说明已经生效。

第 6 步：回到 Google 点"验证"

回到刚才那个还没关掉的 Google Search Console 页面。
点弹窗底部的"验证"按钮。
提示"已验证所有权"，恭喜，第一步完成了。

第 7 步：提交网站地图（Sitemap），帮 Google 找到所有文章

在 Search Console 左侧菜单里，找到并点击"站点地图"（Sitemaps）。
在"添加新的站点地图"那一栏，只需要填写 sitemap.xml：
code
```
sitemap.xml
```
完整路径会自动变成：https://freecat-blog.pages.dev/sitemap.xml
点"提交"按钮。
状态显示"成功"就完成了。Google 会在接下来几天到几周内陆续把你的文章收录进搜索结果。

二、Bing 站长平台（让必应、ChatGPT 等找到你）

小提示：Bing 的数据被 ChatGPT、Copilot 等很多 AI 工具使用，加入 Bing 之后，AI 也能更容易找到你的博客。

第 1 步：打开官方网址，登录账号

浏览器打开：https://www.bing.com/webmasters
点页面上的"立即开始"（Get started）按钮。
登录方式可以从这三个里选一个，都行：
- Microsoft 账号（微软账号，没有可以注册一个）
- Google 账号
- Facebook 账号
建议用 Google 账号 登录，因为下一步可以直接把 Google Search Console 里的信息一键导入。

第 2 步：添加你的网站（两条路任选一条）

登录后会进入"添加网站"页面，给你两条路：

路线 A（最快，推荐）：从 Google Search Console 导入

前提：你已经完成上面那份 Google 教程，并且用 Google 账号登录 Bing。

左边那块大方框写着"导入"（Import）。
点蓝色"导入"按钮。
会弹出一个 Google 授权页面，点"继续"或"允许"。
Bing 会列出你在 Google Search Console 里的所有网站，勾选 https://freecat-blog.pages.dev，点"导入"。
几秒钟后就完成，不需要再次验证，跳到第 5 步提交 Sitemap 即可。

路线 B：手动添加

如果不想用导入，可以手动加：

右边那块方框写着"手动添加站点"（Add your site manually）。
在输入框里填入：
code
```
https://freecat-blog.pages.dev
```
点"添加"按钮。
接着按下面第 3、第 4 步去验证。

第 3 步：选择验证方式（手动添加才需要）

页面会让你选验证方式，推荐选"Meta 标签"（HTML Meta Tag），和 Google 那种一样最简单。

找到"Meta 标签"那一项，点开。
会显示一段代码，例如（同样以你自己页面上的为准）：
html
```
<meta name="msvalidate.01" content="XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" />
```
点右边的"复制"按钮。

第 4 步：把验证代码贴到网站里（手动添加才需要）

打开本项目里的这个文件：

code

Control/SEO_搜索优化.md

在文件里找到 bing_html_marker: 这一行，把你刚刚复制的整段 Meta 标签粘贴到冒号后面。粘贴完大概长这样：

yaml
 
bing_html_marker: <meta name="msvalidate.01" content="XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" />

保存 → 提交 → 推送 → 等 Cloudflare Pages 部署完（1～2 分钟）。

然后回到 Bing 页面，点"验证"按钮。提示"验证成功"即完成。

第 5 步：提交网站地图（Sitemap）

登录 Bing 站长平台主界面后，左侧菜单里点"站点地图"（Sitemaps）。
点右上角的"提交站点地图"按钮。
弹窗里填入你网站的完整 Sitemap 地址：
code
```
https://freecat-blog.pages.dev/sitemap.xml
```
注意：和 Google 不一样，Bing 这里要填 完整网址，不是只填 sitemap.xml。
点"提交"。
看到列表里出现这一条、状态是"成功"，就大功告成。

三、验收清单

完成上面两份教程后，你的网站应该达到下面这个状态。逐项对照检查一下：

浏览器打开 https://freecat-blog.pages.dev 能正常访问
网页源代码里能搜到 google-site-verification（代表 Google 验证已上线）
网页源代码里能搜到 msvalidate.01（如果走的是 Bing 手动添加；用导入方式则不会有）
如果域名托管在 Cloudflare，已经关闭或放行反爬规则，确保搜索引擎能访问 /sitemap.xml 和 /robots.txt
Google Search Console 显示"已验证所有权"
Google Search Console 的站点地图列表里有 sitemap.xml，状态"成功"
Bing 站长平台首页能看到 https://freecat-blog.pages.dev
Bing 站长平台的站点地图列表里有 https://freecat-blog.pages.dev/sitemap.xml，状态"成功"

全部打勾，就说明你的网站已经正式被两大搜索引擎收录追踪。接下来正常写博客就行，新文章一般几天到几周内就会出现在搜索结果里。

四、常见问题

问：验证一直失败怎么办？

先确认 Cloudflare Pages 已经构建完成（去 Cloudflare 后台看"Deployments"是不是显示绿色"Success"）。
在浏览器里打开你的网站，按 Ctrl + Shift + R 强制刷新，再按 Ctrl + U 查看源代码，搜索 google-site-verification 或 msvalidate.01，确认那段代码真的出现在页面里。
出现了再回平台点验证，一般就能过。

问：网址前缀和网域有什么区别？我该选哪个？

"网址前缀"只需要把验证代码贴进网页里，小白选这个。
"网域"需要去你买域名的地方修改 DNS 解析记录，门槛高。除非你想一次性验证整个域名（包括所有子域名），否则不需要碰它。

问：Sitemap 提交后多久能看到文章被收录？

Google 一般几天到 2 周，Bing 一般 1～4 周。新站需要耐心，期间不用反复重新提交。

问：浏览器能打开 sitemap.xml，但 Google Search Console 一直显示 Couldn't fetch，或者 Bing 一直读取失败，怎么办？

先在浏览器里分别打开你自己的 https://你的域名/sitemap.xml 和 https://你的域名/robots.txt，确认两个地址都能正常显示。
如果你的域名托管在 Cloudflare，优先检查 Cloudflare 后台的反爬和机器人防护设置。关闭 Bot Fight Mode、WAF 托管质询、Security Rules、AI Crawl Control / Managed robots 等可能拦截搜索引擎的功能，或者单独放行 Googlebot、Bingbot、/sitemap.xml 和 /robots.txt。
改完后清理 Cloudflare 缓存，再回 Google Search Console 或 Bing 站长平台删除旧的 Sitemap 记录，重新提交一次。
重点记住：浏览器能打开，不代表搜索引擎机器人也一定能打开。搜索平台看到的是服务器、DNS、Cloudflare 和反爬规则共同作用后的结果。

问：要不要把这两段 meta 代码删掉？

不要删。删掉之后两个平台会判定你"失去所有权"，可能把你的网站从后台移除。Google 那段永久留在 Control/SEO_搜索优化 .md 的 google_html_marker 里；如果你手动添加了 Bing，那段永久留在同一个文件的 bing_html_marker 里。它们对网站没有任何副作用。

音频与视频示例

2026-06-01T00:00:00.000Z

音频示例

I Still Believe

0:00 / 0:00

Your browser does not support the audio element.

视频示例

中餐是不是健康饮食？

0:00 / 0:00

Markdown 格式完整测试文档

2026-01-17T00:00:00.000Z

欢迎使用 `Arya` 在线 Markdown 编辑器

Arya，是一款基于 Vue、Vditor，为未来而构建的在线 Markdown 编辑器；轻量且强大：内置粘贴 HTML 自动转换为 Markdown，支持流程图、甘特图、时序图、任务列表，可导出携带样式的图片、PDF、微信公众号特制的 HTML 等等。

如何使用

微注：清空目前这份默认文档，即处于可使用态。Arya 另一大优点在于：编辑内容只会在您本地进行保存，不会上传您的数据至服务器，绝不窥测用户个人隐私，可放心使用；Github 源码：markdown-online-editor，部分功能仍在开发🚧，敬请期待。

默认为所见即所得模式，可通过 ⌘-⇧-M（Ctrl-⇧-M）进行切换；或通过以下方式：

所见即所得：⌘-⌥-7（Ctrl-alt-7）；
即时渲染：⌘-⌥-8（Ctrl-alt-8）；
分屏渲染：⌘-⌥-9（Ctrl-alt-9）；

PPT 预览

如果您用作 PPT 预览（入口在设置中），需要注意，这里暂还不能支持各种图表的渲染；您可以使用 --- 来定义水平方向上幻灯片，用 -- 来定义垂直幻灯片；更多设定可以参见 RevealJs 文档。

什么是 Markdown

Markdown 是一种方便记忆、书写的纯文本标记语言，用户可以使用这些标记符号，以最小的输入代价，生成极富表现力的文档：譬如您正在阅读的这份文档。它使用简单的符号标记不同的标题，分割不同的段落，粗体、斜体或者超文本链接，更棒的是，它还可以：

1. 制作待办事宜 `Todo` 列表

🎉 通常 Markdown 解析器自带的基本功能；
🍀 支持 流程图 、 甘特图 、 时序图 、 任务列表；
🏁 支持粘贴 HTML 自动转换为 Markdown；
💃🏻 支持插入原生 Emoji、设置常用表情列表；
🚑 支持编辑内容保存 本地存储，防止意外丢失；
📝 支持 实时预览，主窗口大小拖拽，字符计数；
🛠 支持常用快捷键(Tab)，及代码块添加复制
✨ 支持导出携带样式的 PDF、PNG、JPEG 等；
✨ 升级 Vditor，新增对 echarts 图表的支持；
👏 支持检查并格式化 Markdown 语法，使其专业；
🦑 支持五线谱、及部分站点、视频、音频解析；
🌟 增加对 所见即所得 编辑模式的支持(⌘-⇧-M)；

2. 书写一个质能守恒公式 ¹

E=mc^2

3. 高亮一段代码 ²

js
 
// 给页面里所有的 DOM 元素添加一个 1px 的描边（outline）;
[].forEach.call($$("*"),function(a){
  a.style.outline="1px solid #"+(~~(Math.random()*(1<<24))).toString(16);
})

4. 高效绘制流程图

graph TD A[用户请求] --> B[语义解析] B --> C[RAG 检索] C -->|✅ 知识库匹配| D[上下文增强] C -->|❌ 无匹配| E[任务分解] D --> E E --> F{工具选择} F -->|🛠️ 核心工具| G{基础操作} F -->|🔌 MCP 扩展服务| H{MCP 操作} G -->|✏️ 文件操作| I[读写/替换] G -->|🖥️ 系统命令执行| J[执行命令] G -->|🔍 代码分析| K[代码分析] H -->|⚙️ 使用 MCP 工具| L[使用 MCP 工具] H -->|📦 访问 MCP 资源| M[访问 MCP 资源] I --> N[结果验证] J --> N K --> N L --> N M --> N N --> O{完成判断} O -->|✅| P[提交最终结果] O -->|❌| E

5. 高效绘制序列图

sequenceDiagram participant Alice participant Bob Alice->John: Hello John, how are you? loop Healthcheck John->John: Fight against hypochondria end Note right of John: Rational thoughts <br/>prevail... John-->Alice: Great! John->Bob: How about you? Bob-->John: Jolly good!

6. 高效绘制甘特图

甘特图 内在思想简单。基本是一条线条图，横轴表示时间，纵轴表示活动（项目），线条表示在整个期间上计划和实际的活动完成情况。它直观地表明任务计划在什么时候进行，及实际进展与计划要求的对比。

gantt title 项目开发流程 section 项目确定需求分析 :a1, 2019-06-22, 3d 可行性报告 :after a1, 5d 概念验证 : 5d section 项目实施概要设计 :2019-07-05 , 5d 详细设计 :2019-07-08, 10d 编码 :2019-07-15, 10d 测试 :2019-07-22, 5d section 发布验收发布: 2d 验收: 3d

7. 支持图表

备注：上述 echarts 图表📈，其数据，须使用严格的 JSON 格式；您可使用 JSON.stringify(data)，将对象传换从而得标准数据，即可正常使用。

8. 绘制表格

作品名称	在线地址	上线日期
逍遥自在轩	https://www.niceshare.site	2024-04-26
玉桃文飨轩	https://share.lovejade.cn	2022-08-26
缘知随心庭	https://fine.niceshare.site	2022-02-26
静轩之别苑	http://quickapp.lovejade.cn	2019-01-12
晚晴幽草轩	https://www.jeffjade.com	2014-09-20

9. 更详细语法说明

想要查看更详细的语法说明，可以参考这份 Markdown 资源列表，涵盖入门至进阶教程，以及资源、平台等信息，能让您对她有更深的认知。

总而言之，不同于其它 所见即所得 的编辑器：你只需使用键盘专注于书写文本内容，就可以生成印刷级的排版格式，省却在键盘和工具栏之间来回切换，调整内容和格式的麻烦。Markdown 在流畅的书写和印刷级的阅读体验之间找到了平衡。 目前它已经成为世界上最大的技术分享网站 GitHub 和技术问答网站 StackOverFlow 的御用书写格式，而且越发流行，正在在向各行业渗透。

Markdown 格式完整测试

📋 所有格式枚举测试

这是一个包含所有 Markdown 格式的完整测试文档，用于检查社交平台兼容性。

1️⃣ 标题层级测试

一级标题 H1

二级标题 H2

三级标题 H3

四级标题 H4

五级标题 H5

六级标题 H6

2️⃣ 文本格式测试

基础文本格式

粗体文本 和 另一种粗体语法
斜体文本 和 另一种斜体语法
粗斜体文本 和 另一种粗斜体
~~删除线文本~~
行内代码 示例
普通文本和混合格式测试

特殊字符和转义

反引号: `code`
星号: *text*
下划线: _text_
波浪号: ~~text~~

3️⃣ 列表测试

无序列表

第一项
第二项
- 嵌套项 1
- 嵌套项 2
- 深层嵌套项
- 另一个深层项
- 嵌套项 3
第三项
包含粗体和斜体的项
包含 代码 的项

有序列表

第一项
第二项
1. 嵌套有序项 1
2. 嵌套有序项 2
3. 深层嵌套
4. 另一个深层嵌套
5. 嵌套有序项 3
第三项
包含格式的项
包含 代码 的项

任务列表

已完成任务
另一个已完成任务
未完成任务
包含粗体的任务
包含 代码 的已完成任务
包含链接的任务

4️⃣ 引用块测试

简单引用

这是一个简单的引用块。

多行引用

这是多行引用的第一行。

这是第二行，中间有空行。

这是第三行。

嵌套引用

这是外层引用。

这是嵌套引用。

这是更深层的嵌套引用。

回到外层引用。

引用中的格式

引用中可以包含粗体、斜体和 代码。

也可以包含链接。

5️⃣ 代码测试

行内代码

这是 行内代码 示例，包含 console.log('Hello') 这样的代码片段。

代码块（无语言标识）

code

这是没有语言标识的代码块
可以包含任意文本
保持原有格式和缩进

JavaScript 代码块

javascript
 
// JavaScript 代码示例
function greet(name) {
  console.log(`Hello, ${name}!`);
  return `Welcome, ${name}`;
}

const user = 'World';
greet(user);

Mermaid 复杂图示例

flowchart TB subgraph Cluster_A [订单流转域] direction TB A[用户下单] --> B{库存检查} B -- 库存充足 --> C[预占库存] B -- 库存不足 --> D[下发缺货通知] C --> E{支付结果} E -- 成功 --> F[生成订单] E -- 失败 --> G[释放库存] end subgraph Cluster_B [履约域] direction LR F --> H[拣货打包] H --> I{发货方式} I -- 自营 --> J[自营配送] I -- 第三方 --> K[三方物流] end J --> L[签收] K --> L L --> M{是否售后} M -- 否 --> N[订单完成] M -- 是 --> O[售后流程]

6️⃣ 数学公式测试

行内公式

爱因斯坦质能方程 $E = mc^2$ 是物理学中最著名的公式之一。

圆的面积公式为 $A = \pi r^2$ ，其中 $r$ 是半径。

块级公式

x = \frac{-b \pm \sqrt{b^2 - 4ac}}{2a}

7️⃣ 表格测试

简单表格

列 1	列 2	列 3
数据 1	数据 2	数据 3
数据 4	数据 5	数据 6

对齐表格

左对齐	居中对齐	右对齐
左	中	右
数据较长的内容	居中内容	右侧内容

包含格式的表格

功能	语法	示例
粗体	`text`	示例文本
斜体	`text`	示例文本
链接	`[text](url)`	GitHub

8️⃣ 分割线测试

使用三个或更多连字符：

使用三个或更多星号：

使用三个或更多下划线：

📝 测试总结

以上包含了所有常用的 Markdown 格式：

✅ 已测试格式：

标题（H1-H6）
文本格式（粗体、斜体、删除线、行内代码）
列表（有序、无序、任务列表、嵌套）
引用块（简单、多行、嵌套）
代码块（多种语言）
数学公式（行内公式、块级公式）
表格（简单、对齐、包含格式）
分割线

🎯 测试目标：检查所有格式在社交平台中的显示效果和兼容性。

引用自：https://mmdeditor.boxtech.icu

bm.md

bm.md 是一个专业的 Markdown 排版工具，专为内容创作者设计。本文档详细介绍所有功能特性。

NOTE

复制到知乎、掘金功能还在开发中，敬请期待。

多文件管理

文件标签页

支持同时打开多个 Markdown 文件：

多标签切换 - 顶部标签栏显示所有打开的文件
双击重命名 - 双击标签可重命名文件
自动命名 - 根据文档首个 H1 标题自动命名
IndexedDB 存储 - 文件内容持久化存储，刷新不丢失
新建文件 - 点击 + 按钮创建新文件
关闭文件 - 点击标签上的 ✕ 关闭文件

文件存储

文件元数据存储在 LocalStorage
文件内容存储在 IndexedDB
浏览器不支持时自动降级为内存存储

编辑器功能

Markdown 编辑器

基于 CodeMirror 6 构建的高性能编辑器：

语法高亮 - Markdown 语法实时着色
代码折叠 - 支持折叠代码块和长段落
Ayu 主题 - 与整体 UI 风格统一的编辑器配色

文件导入

支持多种方式导入内容：

本地文件选择 - 支持 .md、.markdown 格式
拖拽导入 - 直接拖拽文件到编辑器区域
粘贴导入 - 支持粘贴 HTML 内容自动转换为 Markdown
快捷键 - Cmd/Ctrl + O 快速打开文件

Markdown 格式化

一键美化 Markdown 代码：

基于 markdownlint 规则自动修复
统一标题、列表、空行等格式
快捷键 Cmd/Ctrl + Shift + L

导出 Markdown

将编辑器内容保存为本地文件：

导出为 .md 文件
快捷键 Cmd/Ctrl + S

预览功能

实时预览

编辑即可见的预览体验：

增量更新 - 使用 morphdom 进行 DOM diff，仅更新变化部分
防抖渲染 - 100ms 防抖，避免频繁渲染
样式隔离 - iframe 沙箱隔离，预览样式不影响编辑器

视图切换

适配不同设备的预览宽度：

移动端视图 - 415px 宽度，iPhone 设备框展示
桌面端视图 - 768px 宽度，Safari 浏览器框展示
自动响应容器宽度变化

滚动同步

编辑器与预览区域双向滚动同步：

编辑器滚动时预览跟随
预览滚动时编辑器跟随
可通过设置开关此功能

主题系统

Markdown 排版样式

内置 13 种精心设计的排版风格：

样式 ID	名称	风格描述
`ayu-light`	Ayu Light	清新淡雅的浅色主题
`bauhaus`	Bauhaus	包豪斯风格，几何与功能主义
`botanical`	Botanical	植物园风格，自然柔和
`green-simple`	GreenSimple	简约绿色风格
`sketch`	Sketch	手绘素描风格
`newsprint`	Newsprint	报纸印刷风格
`terminal`	Terminal	终端/命令行风格
`neo-brutalism`	Neo-Brutalism	新野兽派，大胆对比
`playful-geometric`	Playful Geometric	活泼几何图形风格
`professional`	Professional	专业商务风格
`organic`	Organic	有机自然风格
`maximalism`	Maximalism	极繁主义，丰富装饰
`retro`	Retro	复古怀旧风格

代码高亮主题

支持 10 种代码块高亮主题（来自 highlight.js）：

主题 ID	名称	类型
`tokyo-night-light`	Tokyo Night Light	浅色
`tokyo-night-dark`	Tokyo Night Dark	深色
`panda-syntax-light`	Panda Syntax Light	浅色
`panda-syntax-dark`	Panda Syntax Dark	深色
`rose-pine-dawn`	Rosé Pine Dawn	浅色
`rose-pine`	Rosé Pine	深色
`kimbie-light`	Kimbie Light	浅色
`kimbie-dark`	Kimbie Dark	深色
`paraiso-light`	Paraiso Light	浅色
`paraiso-dark`	Paraiso Dark	深色

浅色/深色模式

应用整体支持浅色和深色两种模式：

基于 next-themes 实现
View Transition API 实现平滑切换动画

自定义 CSS

在主题样式基础上进行二次定制：

点击预览区工具栏的画笔图标打开配置
CSS 选择器需约束在 #bm-md 下
自定义样式在主题样式之后应用，可覆盖默认样式
支持通过 API/MCP 传入 customCss 参数
配置自动保存到本地存储

示例：

css
 
/* 修改标题颜色 */
#bm-md h1 {
  color: #e74c3c;
}

/* 调整段落行高 */
#bm-md p {
  line-height: 1.8;
}

/* 自定义引用块样式 */
#bm-md blockquote {
  border-left-color: #9b59b6;
  background: #f8f4fc;
}

多平台导出

一键复制

针对不同平台优化的复制功能：

平台	快捷键	特殊处理
微信公众号	`Cmd/Ctrl + Shift + 7`	链接转脚注、代码空格保护、表格滚动适配
~~知乎专栏~~	`Cmd/Ctrl + Shift + 8`	~~适配知乎编辑器~~
掘金	`Cmd/Ctrl + Shift + 9`	~~适配掘金编辑器~~
HTML	`Cmd/Ctrl + Shift + 0`	通用 HTML 输出

所有输出均使用 CSS 内联（通过 juice），可直接粘贴到富文本编辑器。

图片导出

将预览内容导出为图片：

使用 SnapDom 进行截图
输出 JPEG 格式

图片上传

临时图片存储

支持上传图片到临时存储：

S3 兼容存储（可配置）
支持拖拽图片到编辑器
支持粘贴剪贴板图片
文件大小限制 5MB
支持常见图片格式

开发者集成

REST API

提供 4 个核心 API 端点：

端点	功能
`POST /api/markdown/render`	Markdown 渲染为 HTML
`POST /api/markdown/parse`	HTML 转换为 Markdown
`POST /api/markdown/extract`	提取纯文本
`POST /api/markdown/lint`	格式校验与修复

完整 API 文档可访问 /docs 查看（Scalar UI）。

MCP 协议

支持 Model Context Protocol，可集成到 AI Agent：

提供 4 个工具：render、parse、extract、lint
Streamable HTTP 传输
配置说明可访问 /docs/mcp 查看

PWA 支持

离线访问

应用支持 PWA（渐进式 Web 应用）：

离线可用 - 核心功能无需网络
可安装 - 支持添加到主屏幕
文件关联 - 支持在操作系统中直接用 bm.md 打开 .md 文件

快捷操作

命令面板

类似 Raycast/Spotlight 的全局命令面板：

Cmd/Ctrl + K 打开
搜索所有可用命令
支持子菜单（主题选择等）

编辑器设置

可配置的编辑器行为：

设置	说明
引用链接列表	将文中链接转换为脚注形式
新窗口打开链接	为链接添加 `target="_blank"`
滚动同步	编辑器与预览双向滚动同步

Markdown 语法支持

基础语法

标题

一级标题

二级标题

三级标题

四级标题

五级标题

六级标题

文本格式

这是 粗体文本，这是斜体文本，这是 ~~删除线文本~~，这是 粗斜体文本。

列表

无序列表：

项目一
项目二
- 嵌套项目
- 另一个嵌套

有序列表：

第一项
第二项
1. 嵌套项目
2. 另一个嵌套

引用块

这是一段引用文字，可以用来强调重要内容或引用他人观点。

引用可以包含多个段落。

这是嵌套引用，用于多层次的引用场景。

代码

行内代码：使用 const x = 1 定义常量。

代码块示例：

javascript
 
function greet(name) {
  console.info(`Hello, ${name}!`)
}

greet('World')

链接与图片

这是一个普通链接，这是一个带标题的链接。

bm.md

GFM 扩展

表格

功能	状态	备注
实时预览	✅ 完成	核心功能
多平台导出	✅ 完成	微信/ 知乎 / 掘金
图片上传	✅ 完成	S3 存储

任务列表

支持基础 Markdown 语法
支持 GFM 扩展语法
支持数学公式渲染
支持 Mermaid 图表（计划中）

自动链接

直接输入 URL 自动识别：https://bm.md

邮箱地址也支持：bm.md@bm.md

高级功能

脚注

Markdown³ 是一种轻量级标记语言，由 John Gruber⁴ 于 2004 年创建。

数学公式

支持 KaTeX 渲染。行内公式： $E = mc^2$ ，质能方程揭示了质量与能量的关系。

块级公式：

\sum_{i=1}^{n} x_i = x_1 + x_2 + \cdots + x_n

GitHub Alert

NOTE

这是一条提示信息，用于补充说明。

TIP

这是一条小技巧，帮助用户更好地使用功能。

IMPORTANT

这是重要信息，请务必注意。

WARNING

这是警告信息，操作前请三思。

CAUTION

这是危险警告，可能导致数据丢失或不可逆操作。

引用自：https://bm.md

↩↩
↩↩
Markdown 文件通常使用 .md 或 .markdown 扩展名。↩
John Gruber 是 Daring Fireball 博客的创始人。↩

这是一篇空白内容的模板文章，用于复制和编辑

2012-01-01T00:00:00.000Z

这是一篇空白内容的模板文章，用于复制和编辑。

好看的封面图可到 https://www.pinterest.com 搜寻。

FreeCat Blog

Freecat Blog 免费博客构建指南 | 本地写作 + GitHub 备份 + 免费部署

为什么选择 Freecat Blog

最短部署路径预览

最短使用路径预览

就三件事

新手怎么挑部署平台

首选：Cloudflare Pages

备选：Vercel

动手前准备这些

第一步：建一个自己的博客仓库

1. 登录 GitHub

2. 打开 Importer 页面

3. 填写导入表单

4. 开始导入

5. 下载到本地

第二步：部署参数速查表

方案一：部署到 Cloudflare Pages

第 1 步：进入 Cloudflare Pages

第 2 步：填写构建配置

第 3 步：访问默认网址

第 4 步：以后怎么更新网站

第 5 步：绑定自己的域名

Cloudflare Pages 常见坑

坑 1：根目录没填 all

坑 2：输出目录填成 all/dist

坑 3：随便选了框架预设

坑 4：网站没更新就以为失败

方案二：部署到 Vercel

第 1 步：导入 GitHub 仓库

第 2 步：把 Root Directory 选成 all 文件夹

第 3 步：部署并访问

第 4 步：绑定自己的域名

第三步：开始写文章

第四步：个性化网站

site_网站属性 .md

social_社交媒体 .md

about_关于页面 .md

日常更新流程

文章内音频、视频播放器

音频播放器

视频播放器

从网盘分享链接转换成直链

模板更新怎么同步过来

进阶：用 Obsidian 做本地写作中心

进阶：本地预览和构建

进阶：先用好皮肤，再考虑改皮肤

进阶：怎么搭配 AI 一起用

常见问题

我必须会编程吗

我必须先买域名吗

.gitignore 是什么，什么时候要用

为什么我本地改完了，网站没变

以后能从 Vercel 换到 Cloudflare Pages 吗

我最容易填错什么

可以删除示例文章吗

可以直接改 all/ 吗

把网站交给 Google 和 Bing —— 小白零基础教程

一、Google Search Console（让 Google 找到你）

第 1 步：打开官方网址，登录账号

第 2 步：添加你的网站

第 3 步：验证你是网站的主人

第 4 步：把验证代码贴到网站里

第 5 步：把改动发布到线上

第 6 步：回到 Google 点"验证"

第 7 步：提交网站地图（Sitemap），帮 Google 找到所有文章

二、Bing 站长平台（让必应、ChatGPT 等找到你）

第 1 步：打开官方网址，登录账号

第 2 步：添加你的网站（两条路任选一条）

路线 A（最快，推荐）：从 Google Search Console 导入

路线 B：手动添加

第 3 步：选择验证方式（手动添加才需要）

第 4 步：把验证代码贴到网站里（手动添加才需要）

第 5 步：提交网站地图（Sitemap）

三、验收清单

四、常见问题

音频与视频示例

音频示例

视频示例

Markdown 格式完整测试文档

坑 1：根目录没填 `all`

坑 2：输出目录填成 `all/dist`

`site_网站属性 .md`

`social_社交媒体 .md`

`about_关于页面 .md`

`.gitignore` 是什么，什么时候要用

可以直接改 `all/` 吗

欢迎使用 `Arya` 在线 Markdown 编辑器

1. 制作待办事宜 `Todo` 列表

2. 书写一个质能守恒公式 ¹

3. 高亮一段代码 ²