一个永久免费使用的博客系统

写博客是让思考沉淀、让成长可见、让机会敲门的最便宜方式。

GitHub 是全球领先的代码托管与协作开发平台，通过分布式 Git 版本库、多地冗余热备与“千年北极存档”计划，让公开数据具备近似永久保存的抗灾能力。

0. 准备工作

1. 注册 GitHub
   https://github.com → 右上角 Sign up → 邮箱验证。
2. 记住你的用户名，下文全部用 你的用户名 代替。

1. 一键生成博客仓库

1. 打开模板
   https://github.com/Meekdai/Gmeek-template
   点击中间绿色 Use this template → Create a new repository。

2. 必填：

   • Repository name 必须写成 你的用户名.github.io（例：xiaobai.github.io）
   • 选 Public → 勾选 Include all branches → Create repository。

2. 打开 GitHub Pages 开关

仓库页面 → Settings → 左侧 Pages → Source 选 GitHub Actions → 自动保存。

3. 手动触发第一次编译

仓库顶部 Actions → 左侧 build Gmeek → 右侧 Run workflow → 再点一次绿色 Run workflow。
等 30 s~2 min 出现绿色 ✔️ 即可。

4. 确认博客已上线

浏览器访问
https://你的用户名.github.io
能看到示例页面即成功！

5. 发表第一篇文章

1. 仓库 → Issues → New issue。

2. 填写：

   • Title：文章标题
   • Write：正文（支持 Markdown）
   • 右侧 Labels：必须至少勾选一个（如 blog）
3. Submit new issue → 等 30 s → 刷新首页，文章出现。

以后每写一篇重复 5 即可，完全不用碰代码。

6. 自定义博客标题 / 头像

仓库 → Add file → Create new file → 文件名 config.json：

{
  "title": "小白的技术日记",
  "subTitle": "记录学习点滴",
  "avatarUrl": "https://avatars.githubusercontent.com/你的用户名",
  "GMEEK_VERSION": "last",
  "homeUrl": "https://你的用户名.github.io",
  "email": "你的邮箱@qq.com",
  "startSite": "06/10/2024",
  "onePageListNum": 10,
  "i18n": "CN",
  "UTC": 8,
  "themeMode": "manual"
}

→ 下方 Commit changes → 再 Run workflow 一次。

7. 插入图片

直接把图片拖进 Issue 编辑框，GitHub 会自动生成 Markdown 地址，发表即可。

8. 删除 or 置顶

删除文章 关闭（Close）对应 Issue → Run workflow
置顶文章 Issue 右上角 Pin issue → Run workflow

9. 绑定自定义域名（可选）

1. 域名后台添加 CNAME 记录 → 指向 你的用户名.github.io
2. 仓库新建文件 CNAME，内容写 www.你的域名.com → 保存 → Run workflow
3. 等待 DNS 生效

10. Markdown 常用语法

# 一级标题
**加粗**  *斜体*
> 引用
- 列表项
[链接](URL)
![图片](URL)

完整教程：https://www.runoob.com/markdown/md-tutorial.html

11. 一句话记住全流程

“ 发 Issue + 选标签 → 等 30 秒 → 博客自动更新！”

祝写作愉快！

项目地址：https://github.com/Meekdai/Gmeek

官方教程：https://blog.meekdai.com/tag.html#Gmeek