写一篇文章只需三步
本博客基于 Astro 的内容集合(Content Collections),写作流程非常简单。
第一步:新建 Markdown 文件
在 src/content/blog/ 目录下新建一个 .md 文件,文件名就是文章的 URL:
src/content/blog/my-new-post.md → /blog/my-new-post
第二步:填写 Frontmatter
文件顶部用 --- 包裹的元信息是必填的:
---
title: '文章标题'
description: '一句话描述,会显示在列表和 SEO 中'
pubDate: 2026-07-24
tags: ['标签1', '标签2']
---
还有一些可选字段:
| 字段 | 说明 |
|---|---|
updatedDate | 更新日期 |
draft | 设为 true 则不会发布 |
tags | 标签数组,会显示在文章卡片上 |
第三步:正常写 Markdown
支持完整的 Markdown 语法:标题、列表、表格、代码块、图片、引用……
// 代码块自带语法高亮
function greet(name: string) {
console.log(`Hello, ${name}!`);
}
本地预览
npm run dev
启动后访问 http://localhost:4321,修改文件会热更新,所见即所得。
部署
npm run build # 构建到 dist/
npm run preview # 本地预览构建结果
构建产物是纯静态文件,可以部署到 Vercel、Netlify、GitHub Pages 等任何静态托管平台。
快去写你的第一篇文章吧!