如何写一篇文章

这篇是给未来的自己看的操作指南——几个月没写博客之后,打开这篇就能想起来。

完整流程(本地写作)

第一步:新建文章文件

文章放在 src/content/posts/ 目录,文件名用英文短横线命名(slug),比如 summer-notes.md

cd /Users/a1/AIAssistant/VibeCoding/LiveTheMoment
touch src/content/posts/<slug>.md

第二步:写 front matter(文章头部信息)

---
title: "文章标题"
date: 2026-08-09T12:00:00+08:00
description: "一句话摘要"
categories: ["生活"]        # 生活 / 学习 / 技术
tags: ["随笔"]
draft: false                # true = 草稿不发布
---

第三步:写正文(Markdown)

标题从 ## 开始,代码块标注语言。写完本地预览:

hugo server --source src     # 浏览器打开 http://localhost:1313

第四步:发布

git add -A
git commit -m "feat: 新文章 <标题>"
git push origin main         # 约 1 分钟后自动上线

手机上怎么写(随手记)

手机上不写完整文章,只随手记

  1. 用系统备忘录或 Notion 记录灵感、片段、草稿
  2. 回到电脑后,把随手记整理扩写成一篇文章,按上面的流程发布

随手记是草稿箱,不是发布工具——这样博客永远只有一种发布方式,简单且稳定。

应急编辑(不在电脑前)

GitHub 网页端直接编辑:

  1. 手机浏览器打开仓库页面(GitHub App 更佳)
  2. 进入 src/content/posts/,编辑或新建 .md 文件
  3. 提交 commit(消息写清改动内容)

push 一样会自动触发发布。

常见问题

文章写了一半不想发?draft 改成 true,本地可见、线上不发布。

想改文章? 直接编辑文件,重新 push 即可,线上自动更新(旧版本在 Git 历史里)。

标题想改? 文件里的 title 随时可改。但文件名(slug)发布后不要改——改了链接就变了,会断掉外链。如果必须改,用 aliases 加旧地址重定向。