从本地 Markdown 到线上博客

2026年05月26日 1 分钟阅读

这个博客采用静态发布方式:内容不是写进数据库,而是写进 Markdown 文件。

完整流程是:

  1. 在本地写 Markdown。
  2. 把文章放入博客项目的 src/content/blog/
  3. 提交到 GitHub。
  4. Vercel 自动构建并发布到 blog.518.cash

文章文件格式

一篇文章的基本结构如下:

---
title: "文章标题"
description: "一句话摘要"
date: "2026-05-27"
tags: ["标签一", "标签二"]
cover: "/images/cover.jpg"
draft: false
---

正文内容写在这里。

如果 draft: true,这篇文章不会发布到线上。

图片怎么处理

图片可以放在 public/images/ 目录。文章里这样引用:

![图片说明](/images/cover.jpg)

这让文章和图片都保存在同一个仓库里,迁移和备份都比较简单。