如何写一篇文章
这篇是给未来的自己看的操作指南——几个月没写博客之后,打开这篇就能想起来。
完整流程(本地写作)
第一步:新建文章文件
文章放在 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 分钟后自动上线
手机上怎么写(随手记)
手机上不写完整文章,只随手记:
- 用系统备忘录或 Notion 记录灵感、片段、草稿
- 回到电脑后,把随手记整理扩写成一篇文章,按上面的流程发布
随手记是草稿箱,不是发布工具——这样博客永远只有一种发布方式,简单且稳定。
应急编辑(不在电脑前)
GitHub 网页端直接编辑:
- 手机浏览器打开仓库页面(GitHub App 更佳)
- 进入
src/content/posts/,编辑或新建.md文件 - 提交 commit(消息写清改动内容)
push 一样会自动触发发布。
常见问题
文章写了一半不想发? 把 draft 改成 true,本地可见、线上不发布。
想改文章? 直接编辑文件,重新 push 即可,线上自动更新(旧版本在 Git 历史里)。
标题想改? 文件里的 title 随时可改。但文件名(slug)发布后不要改——改了链接就变了,会断掉外链。如果必须改,用 aliases 加旧地址重定向。