发布文章

这个博客系统提供 三种发布方式，适合不同技术背景的人。你可以根据自己的情况选择最合适的路径。

快速对比

路径一：后台写作（零代码）

像用公众号后台一样写文章。

打开浏览器，登录你的博客后台，直接在网页上写文章、添加图片、点击发布。所见即所得，不需要任何技术知识。

适合你如果：

• 你只想专注于写内容
• 你习惯在浏览器里操作
• 你不想接触任何代码或命令行

这是最简单的方式，几分钟就能上手。

路径二：Obsidian + Git（适合笔记爱好者）

像在本地写 Word 文档，写完后"上传"到网站。

用 Obsidian（一个流行的本地笔记软件）在自己电脑上写文章，写完后通过 Git（一个文件版本管理工具，可以理解为"文件的时光机"）同步到网站。

适合你如果：

• 你喜欢在本地写笔记，不依赖网络
• 你已经在用 Obsidian 管理知识库
• 你希望文章以文件形式保存在自己电脑上

需要一点学习成本，但好处是你的文章永远在自己手里。详见 Obsidian 工作流。

路径三：API 自动化（程序员专属）

像搭建一条自动化流水线，内容写好后自动发布。

通过 API（应用程序接口）把发布流程自动化。比如从 Notion 自动同步、从其他系统批量导入、或者写脚本定时发布。

适合你如果：

• 你有编程能力，或者团队里有开发者
• 你想把发布流程和其他工具打通
• 你需要批量操作或定时发布

这是最灵活的方式，但需要编程知识。适合让技术同事来搞定。

路径四：本地 MDX + API（文件是源头，后台是运行时）

像维护代码一样维护文章。

如果你习惯在本地用 Markdown 或 MDX 写长文，可以把文章放在自己的 Git 仓库里，然后通过脚本发布到线上 CMS。线上 CMS 负责文章渲染、评论、RSS、搜索、导出和备份；本地 MDX 文件仍然是长期维护的源文件。

先在后台创建一个 API Token，至少授予 posts:read 和 posts:write。需要直接发布时再加 posts:publish。

CMS_API_TOKEN=... pnpm publish:mdx drafts/my-post.mdx --draft
CMS_API_TOKEN=... pnpm publish:mdx drafts/my-post.mdx --publish

脚本会用文章的 slug 查找现有文章：如果存在就更新，不存在就创建。推荐在 MDX frontmatter 里固定这些字段：

---
title: 文章标题
slug: article-slug
status: draft
date: 2026-06-30
tags:
  - AI
  - 独立开发
---

后台仍然适合做临时修正、图片管理、评论审核和站点设置；正式长文建议回到本地 MDX 修改后再同步。

不确定选哪个？

先用后台写作开始。 等你熟悉了博客系统，再根据需要升级到其他方式。三种方式可以混合使用，不冲突。