用 Markdown 写一篇博客
博客里的每一篇文章都是 src/content/blog/ 下的一个 Markdown 文件。新建一个 .md 文件,写好开头的元信息,就能发布。
文章元信息
文件开头用 --- 包起来的部分叫 frontmatter,至少要填这三个字段:
---
title: 文章标题
description: 一句话摘要,会显示在列表和搜索结果里
pubDate: 2026-10-18
---
还可以选填 updatedDate(更新日期)和 draft: true(草稿,构建时自动隐藏)。
常用语法
加粗、斜体、行内代码、链接。
无序列表:
- 第一项
- 第二项
- 支持嵌套
有序列表:
- 第一步
- 第二步
引用:
引用一段别人的话,记得注明出处。
代码块会自动高亮:
function greet(name) {
return `你好,${name}`;
}
console.log(greet('世界'));
表格:
| 语法 | 效果 |
|---|---|
**粗体** | 粗体 |
*斜体* | 斜体 |
`代码` | 代码 |
文件名即链接
文件名会直接变成文章地址。比如 write-in-markdown.md 对应的地址是 /blog/write-in-markdown/,所以文件名最好用英文和短横线。