这是一篇随博客附带的起步指南。你可以保留它，也可以在发布自己的第一篇笔记后删除。

一篇笔记可以很短。一个刚弄明白的概念、一段有用的代码，或一个暂时没有答案的问题，都值得留下来。

从一个小问题开始

不必一次写完整个主题。先回答一个具体问题，再记录你如何找到答案。

可以用下面的结构：

  1. 问题：我想弄明白什么？
  2. 过程：我尝试了什么，哪些方法有效？
  3. 结论：目前能确定什么，还有什么不确定？
  4. 参考：原始资料在哪里？

发布第一篇笔记

文章保存在 GitHub 仓库的 content/posts/ 文件夹。每篇文章使用独立文件夹，正文放在 index.md，图片也可以放在同一个文件夹。

content/posts/
└── my-first-note/
    ├── index.md
    └── screenshot.png

新建一篇 Markdown 文件，在开头填写文章信息：

---
title: "我的第一篇笔记"
date: 2026-10-21T12:00:00+08:00
slug: "my-first-note"
description: "用一句话概括这篇笔记。"
tags: ["学习"]
draft: false
---

从这里开始写正文。

请把日期改成实际写作日期。将 draft 设为 true 可以保存草稿。草稿不会出现在网站、搜索或订阅中。

GitHub 与 Cloudflare Pages 连接完成后，提交到 main 分支的文章会触发重新构建。构建成功后，新内容才会出现在网站上。

用标签建立联系

标签描述一篇笔记涉及的主题，例如「阅读」「Python」或「工具」。同一篇文章可以有多个标签。

先从少量标签开始。等文章多了，再根据实际内容调整。归档页会按时间整理全部笔记，搜索页可以查找标题和正文。

保留修改的空间

笔记可以更新。发现更好的解释时，直接修改原文即可。也可以在文章开头增加 lastmod，记录最近一次修改的日期。

写下来，再慢慢完善。