1
.md 文件 + .astro 模板 ──▶ astro build ──▶ 纯 HTML/CSS/JS 文件（dist/）

1
1. 扫描 src/content/posts/*.md
2
2. 读取每个 .md 的 frontmatter
3
3. 根据 Content Collection schema 校验
4
4. 将 markdown 编译为 HTML
5
5. 应用布局模板（.astro 文件）
6
6. 生成完整的 HTML 页面
7
7. 输出到 dist/ 目录
8
8. pagefind 索引构建（搜索功能）

1
export default defineConfig({
2
  site: "https://blog-astro.pages.dev",  // 站点 URL
3
  base: "/",                              // 基础路径
4
  trailingSlash: "always",                // URL 末尾加 /
5
  // ...integrations
6
});

1
---
2
title: "我的文章标题"
3
published: 2026-07-04
4
description: "文章摘要"
5
tags: [Python, 爬虫]
6
category: "技术"
7
draft: false
8
---
9

10
这里是正文...

1
const postsCollection = defineCollection({
2
  loader: glob({ pattern: "**/*.{md,mdx}", base: "./src/content/posts" }),
3
  schema: z.object({
4
    title: z.string(),           // 必须
5
    published: z.date(),        // 必须
6
    draft: z.boolean().default(false),
7
    tags: z.array(z.string()).default([]),
8
    // ...
9
  }),
10
});

1
draft: z.boolean().optional().default(false),

1
import matter from "gray-matter";
2

3
const mdString = `---
4
title: Hello
5
tags: [a, b]
6
---
7
正文内容`;
8

9
const parsed = matter(mdString);
10
console.log(parsed.data);      // { title: "Hello", tags: ["a", "b"] }
11
console.log(parsed.content);   // "正文内容"

1
const newMd = matter.stringify("新正文", { title: "New", published: "2026-07-04" });
2
// 输出:
3
// ---
4
// title: New
5
// published: '2026-07-04'
6
// ---
7
// 新正文

1
import fs from "fs";           // 文件系统
2
import path from "path";       // 路径处理
3
import { execSync } from "child_process";  // 执行 shell 命令
4
import matter from "gray-matter";           // frontmatter 解析

1
import { execSync } from "child_process";
2

3
// 同步执行，输出到终端
4
execSync("pnpm build", { stdio: "inherit" });
5

6
// stdio: "inherit" → 子进程的输出直接显示在当前终端
7
// 不加的话，输出会被捕获到 buffer，用户看不到进度

1
import path from "path";
2

3
path.resolve("src/content/posts");   // 相对路径 → 绝对路径
4
path.join(dir, fileName);            // 安全拼接路径（自动处理 / 和 \）
5
path.basename("/a/b/c.md");         // "c.md"
6
path.basename("/a/b/c.md", ".md");  // "c"
7
path.extname("/a/b/c.md");          // ".md"

1
// 命令: node script.js --new "Hello World" --no-draft
2
process.argv  // ["node", "script.js", "--new", "Hello World", "--no-draft"]
3
process.argv.slice(2)  // ["--new", "Hello World", "--no-draft"]

1
fzy.it.com ──(DNS CNAME)──▶ blog-astro.pages.dev ──▶ Cloudflare 边缘节点

1
Server: cloudflare
2
Cf-Cache-Status: DYNAMIC

1
name = "blog-astro"
2
compatibility_date = "2026-05-30"
3

4
[pages]
5
output_dir = "dist"
6
build_command = "pnpm run build"

1
on:
2
  push:
3
    branches: [main]
4

5
jobs:
6
  build-and-deploy:
7
    steps:
8
      - checkout        # 拉取代码
9
      - setup pnpm/node # 安装环境
10
      - pnpm build      # 构建
11
      - deploy to pages # 部署到 pages 分支（GitHub Pages）

1
Git push main → Cloudflare 自动检测 → 在自己的容器中构建 → 部署到 CDN