如何写一篇博客:Markdown 写作与发布流程

本站没有后台、没有数据库:文章就是 src/content/posts/ 目录下的 Markdown 文件。

写一篇文章

新建 src/content/posts/my-post.md(文件名即 URL,用英文短横线命名):

---
title: "文章标题"
description: "一句话摘要,会显示在列表和 SEO 描述里"
pubDate: 2026-10-10
tags: ["随笔", "技术"]
draft: false
---

正文从这里开始。支持完整的 Markdown 语法:

- 列表、引用、表格
- 代码块(带语法高亮)
- 图片(放到 public/ 目录下引用)

Frontmatter 说明:

字段	必填	说明
title	✅	标题
description	✅	摘要(列表卡片 + meta 描述)
pubDate	✅	发布日期,如 2026-10-10
updatedDate	❌	更新日期
tags	❌	标签数组
draft	❌	true 时不出现在站点(草稿)

发布

bash m2-setup.sh

构建并发布,约 30 秒。然后刷新 blog.x2245.com 就能看到。

小技巧

• 代码块写明语言( ts、bash),享受高亮
• 图片放 public/images/,正文里 ![描述](/images/xxx.png)
• 没写完的文章设 draft: true,不会发布
• 发布后记得 git commit,文章就是代码,版本历史就是编辑历史