MakerJackie

01mvp-blog-starter

一个开箱即用的个人博客系统,帮你快速拥有自己的网站。

30 秒理解这个项目

一句话总结:这是一个「个人博客网站模板」——你 fork 它、配置一下、部署上线,就拥有了一个属于自己的博客网站。

适合谁:想长期维护个人品牌、写文章、沉淀内容的人。不管你是产品经理、设计师、独立开发者还是自媒体人,只要你想有一个自己完全掌控的网站(不依赖任何平台),这个模板就适合你。

它解决什么问题

  • 微信公众号、知乎、掘金……这些平台的内容不属于你,平台可能删文、限流、甚至关停
  • 自建网站通常需要大量技术知识,门槛很高
  • 这个模板把技术部分打包好了,你只需要关心「写什么」

这个网站能做什么

你的网站默认有两个核心区域,核心区别是管理方式:

区域网址用来做什么怎么管理
博客/blog写文章、发动态、接收读者评论/admin 后台里写、存草稿、发布
文档/docs写产品说明、教程、指南在 Git 仓库的 Markdown/MDX 文件里维护

博客适合经常更新的内容——今天的想法、本周的复盘、新产品的发布笔记。它是后台可管理的动态内容系统,可以处理草稿、封面、评论和发布状态。

文档适合长期稳定的内容——产品手册、使用教程、团队规范。它更接近 Obsidian 一类本地 Markdown 笔记:内容放在自己的 Git 仓库和本地文件里,改完提交并随网站重新部署。

如果你不确定内容应该放哪边,可以看 内容系统 的详细对比。

技术栈简介

你不需要理解下面每一项技术,这里只是帮你建立一个大致印象。如果有技术伙伴帮你维护网站,这些信息对他们有用。

技术它是做什么的
Cloudflare Workers你的网站运行的地方(类比:服务员,负责接待每一个访客)
Cloudflare D1存储文章、评论、用户信息的数据库(类比:一个大表格仓库)
Cloudflare R2存储图片、附件、备份的文件柜
React网页界面的搭建工具(类比:装修用的材料)
Tailwind CSS让网页变好看的样式工具
Markdown一种简单的写作格式,用纯文本就能排版

为什么选 Cloudflare?

Cloudflare 是全球最大的网络基础设施公司之一。选它的原因:

  1. 免费额度慷慨——个人博客的访问量,基本不需要付费
  2. 全球加速——不管读者在哪里,打开你的网站都很快
  3. 稳定可靠——大公司的基础设施,不用担心宕机

接下来做什么

如果你是第一次接触这个项目:

  1. 先看 AI 初始化建站——让 AI 帮你从模板部署到 Cloudflare
  2. 再看 使用指南——了解你能用这个网站做什么
  3. 想了解评论功能就看 评论系统

如果你只是想了解架构设计:

  • 内容系统——为什么要有两套内容系统
  • 发布方式——文章有哪些发布途径
  • API——如何用自动化工具和网站交互