从一个地址开始
一个个人博客,可以从很小的东西开始:一个域名、一页介绍,再加上一篇文章。
不必一开始就把所有栏目填满。先给文字一个稳定的地址,以后想到新的事情,再一篇一篇放进来。
这是一篇 Demo 示例文章,用来展示标题、段落、引用与代码的阅读样式。它不是作者的真实经历记录。
内容与样式,各做各的事
文章用 Markdown 保存,网页的外观交给 HTML、CSS 和 Astro 模板。写文章的时候只需要关心内容;改配色、调整字体时,也不必重新排每一篇正文。
| 想做的事 | 修改的位置 |
|---|---|
| 写一篇文章 | src/content/blog/ 下的 Markdown 文件 |
| 调整站点导航 | src/layouts/Base.astro |
| 修改首页布局 | src/pages/index.astro |
| 更换字体和颜色 | src/styles/global.css |
一篇文章的开头
每篇 Markdown 文件上方有一小段信息,用来告诉网站文章的标题、分类和封面:
---
title: 我的一篇新文章
description: 用一句话介绍这篇文章。
date: 2026-10-02
category: 生活随记
cover: /images/notebook.svg
coverAlt: 一本打开的笔记本
demo: false
---
在这段信息下面直接写正文即可。使用 ## 表示二级标题,网站会自动生成文章目录。
第一版,简单一点
这个小站的第一版准备四种页面:
- 首页:介绍自己,推荐一篇文章。
- 文章列表:按分类筛选,也可以搜索标题和简介。
- 文章详情:专注阅读,有目录和代码高亮。
- 关于我:说明这个站点是什么,以及谁在写它。
当它们都好用以后,再考虑评论、相册或其他功能。没有后台的静态博客,也可以成为一个完整的个人网站。
以后,还可以搬家
Astro 构建后会输出网站文件。它们可以放在 Cloudflare Pages,也可以迁移至支持静态文件的 CloudBase。
文章仍然保存在自己的项目里。托管平台发生变化时,内容和页面不需要重新写一遍。
关于内容管理,可以参考 Astro 官方文档。
先把第一篇写下来。剩下的,慢慢来。
x.
谢谢你读到这里。
写下来的东西,会留下来。