入一些想法、记录,和随手写下的东西。

这个博客是怎么搭起来的

目录
  1. 结构
  2. 写一篇新文章
  3. 为什么不用框架
  4. 部署

搭这个站的出发点只有两条:简单,以及不用一直开着。

以前试过在旧电脑上跑个小服务,结果电脑一关站就没了;也试过用现成的博客平台,可模板改到一半就发现哪哪都动不了。这次的方案是:本地生成静态页面,扔到 Cloudflare 上。

结构

整个站就是几个文件,没有数据库,没有后台:

blog/
├─ content/
│  ├─ about.md
│  └─ posts/
│     ├─ hello.md
│     └─ 这个文件.md
├─ assets/        # 样式、脚本、图标
├─ build.mjs      # 把 markdown 变成 html
└─ dist/          # 生成结果,上传的就是它

写一篇新文章

在 content/posts/ 里新建一个 .md 文件,顶上写几行信息:

---
title: 标题
date: 2026-11-18
tags: [随笔, 技术]
summary: 列表页显示的一句话摘要
---

正文从这里开始。

文件名就是网址的一部分。hello.md 会变成 /posts/hello/。

为什么不用框架

Astro、Hugo 当然更强,但这里一共不到一千行代码,依赖只有一个 marked。好处是:

  • 装什么都很慢的机器上,三秒就能重新生成全站;
  • 三年后回来看,代码还能跑;
  • 出问题时,要查的文件只有那么几个。

工具应该简单到你能完全理解它。理解不了的工具,早晚会在某个凌晨给你一个惊喜。

部署

生成完把 dist/ 推到 Cloudflare Pages,剩下的交给它。全球 CDN、免费 HTTPS、自定义域名,都包含在免费额度里,而且不需要服务器。

手机写入、推送上线,整个过程一分钟以内。