我的写作流程:从笔记到发布

· 约 1 分钟

流程设计的核心原则是:写的时候不要碰到发布相关的任何东西。一旦写作过程中需要想“文件放哪、格式对不对、要不要提交”,思路就断了。

三个阶段

1. 草稿:只求快

在笔记软件里建一个 blog/ 目录,想到什么写什么。允许长句、允许 TODO、允许只有三行。

这个阶段的产物没有任何格式要求,双链、标签、随手贴的截图都可以。

2. 成稿:迁移到博客仓库

准备发布时,把内容复制到 src/content/blog/<slug>.md,补齐 frontmatter:

---
title: '标题'
description: '摘要'
pubDate: '2026-10-07'
tags: ['workflow']
---

这一步主要做三件事:换掉双链语法、把图片挪进仓库、把口语化的段落改掉。

3. 发布:本地验证后推送

npm run build    # 构建通过 = 没有语法/链接错误
git add -A && git commit -m "post: 文章标题"
git push

推送后 CI 自动构建发布,大约一分钟。失败的话在 Cloudflare 的构建日志里能直接看到报错行。

为什么不在线写

在线的所见即所得编辑器,写作体验其实很好。问题在两处:

  • 版本控制:改错了想回退到三天前的版本,编辑器通常只能给一个模糊的“历史记录”;
  • 格式归属:排版和内容耦合在同一个编辑器里,换工具等于重排。

Markdown + Git 的组合谈不上优雅,但十年后它一定还读得出来。

一点经验

让发布的阻力尽可能小,让修改的阻力尽可能大。

具体来说:npm run dev 开着热更新,改完立刻看到效果;但真正发布必须手动 git push 一次。这样既不会因为流程繁琐而放弃写字,也不会因为太容易而反复折腾样式。