用 Markdown 写一篇博客

博客里的每一篇文章都是 src/content/blog/ 下的一个 Markdown 文件。新建一个 .md 文件,写好开头的元信息,就能发布。

文章元信息

文件开头用 --- 包起来的部分叫 frontmatter,至少要填这三个字段:

---
title: 文章标题
description: 一句话摘要,会显示在列表和搜索结果里
pubDate: 2026-10-18
---

还可以选填 updatedDate(更新日期)和 draft: true(草稿,构建时自动隐藏)。

常用语法

加粗、斜体、行内代码、链接。

无序列表:

有序列表:

  1. 第一步
  2. 第二步

引用:

引用一段别人的话,记得注明出处。

代码块会自动高亮:

function greet(name) {
  return `你好,${name}`;
}

console.log(greet('世界'));

表格:

语法效果
**粗体**粗体
*斜体*斜体
`代码`代码

文件名即链接

文件名会直接变成文章地址。比如 write-in-markdown.md 对应的地址是 /blog/write-in-markdown/,所以文件名最好用英文和短横线。