← 返回文章列表

Astro 快速上手:如何在这个博客里写文章

介绍本博客的内容管理方式:新建一个 Markdown 文件,就是发布一篇新文章。

写一篇文章只需三步

本博客基于 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 等任何静态托管平台。

快去写你的第一篇文章吧!