g-blog

为只想好好写博客的你，轻松构建个人博客

A personal blog made easy—for those who just want to write

在线演示 · 使用此模板 · 快速部署 · 写作 · 配置 · 主题指南

Live Demo · Use this template · Deployment · Writing · Configuration · Theme Guide

用WordPress需要复杂的维护和性能优化，Ghost的部署高度复杂，Hugo使用繁杂。 WordPress needs maintenance and performance tuning, Ghost is complex to deploy, and Hugo is cumbersome to use.

g-blog 基于GitHub生态实现用 GitHub Issues 在线写作、贴图和发布。不再需要维护任何的东西即可发布您的个人博客。 Built on GitHub, g-blog lets you write, paste images, and publish through GitHub Issues. Publish your personal blog without maintaining anything else.

截图 Screenshots

浅色 Light	深色 Dark

特性 Features

• 在线写作：在Github 上使用Issues 在线写作、图片直贴、标签发布。
  Online writing: Write online in GitHub Issues, paste images directly, and publish with labels.
• 双仓设计：私有仓存草稿，公开仓放网站，完美支持草稿。
  Dual-repo design: Keep drafts private and the generated site public, with full draft support.
• 双数据源：GitHub Issues / 本地 Markdown （旧文章无缝迁移）。
  Dual sources: GitHub Issues / local Markdown (seamless migration for existing posts).
• 内容增强：代码、公式、目录、阅读时长、图片优化。
  Content features: Code, math, TOC, reading time, image optimization.
• 主题与分发：主题、Feed、评论、SEO。
  Themes and distribution: Themes, feeds, comments, SEO.

部署 Deployment

AI 部署（推荐） AI-assisted deployment (recommended)

https://raw.githubusercontent.com/night2049/g-blog/refs/heads/main/gblog-deploy-verify/SKILL.md

阅读此 Skill，帮我部署 g-blog。
Read this Skill and deploy g-blog for me.

手动部署
Manual deployment

1. 创建私有内容仓，启用 Issues 和 Actions。
   Create a private content repository; enable Issues and Actions.
2. 创建公开站点仓，启用 Pages。
   Create a public site repository; enable Pages.
3. 生成 Deploy Key；公钥加入站点仓，私钥保存为内容仓的 BLOG_DEPLOY_KEY。
   Generate a Deploy Key; add the public key to the site repository and save the private key as BLOG_DEPLOY_KEY in the content repository.
4. 修改站点仓地址与基础配置。
   Update the site repository address and basic configuration.
5. 给 Issue 加 published 标签，检查构建。
   Add published to an Issue and check the build.

写作 Writing

在你fork的私有仓库新建 Issue，写完添加 published 标签即可发布。

Create an Issue in your forked private repository, then add published when you are ready to publish.

配置 Configuration

配置项见 CONFIGURATION.md。

See CONFIGURATION.md.

MIT License · Issues