内容组织：文件、语言与附件

文章、独立页面、分类和标签都保存在 content/ 中。用文件夹整理内容，再通过 frontmatter 设置标题、地址和其他信息。

四类内容

每类内容都支持 Markdown、MDX 和嵌套目录。

普通文件使用 hello.md 或 hello.mdx；需要图片和附件时，可以建一个文件夹，用 index.md 或 index.mdx 作为内容包入口。

slug 决定内容的地址。例如 slug: content-bundle 对应默认语言前缀策略下的 /zh/posts/content-bundle/。移动管理目录后，显式设置的 slug 保持不变。

title: 一篇示例文章
slug: example
date: 2026-01-01
description: 用一句话介绍文章。
categories: [guide]
tags: [astro, content]
image: ./cover.webp
featured: true

categories 和 tags 使用分类、标签的 slug；featured: true 将文章放入侧栏的置顶区域。日期与发布状态见发布与迁移。

内容包中的图片和文件可以直接用相对路径引用：

附件示例：纯文本、Python 代码、HTML 页面、Markdown 附件、压缩包。构建时，它们随内容包一起发布。

在同一目录使用 index.zh.mdx、index.en.md 等语言后缀文件，即可为同一篇内容提供译文。独立文件同样支持 hello.zh.md、hello.en.mdx 这样的命名方式。

语言菜单会打开对应内容。更多语言的配置与添加方法见语言与翻译。

pnpm new post my-first-post --title "我的第一篇文章"
pnpm new post a-bundle --use bundle --title "带附件的文章"
pnpm new page contact --use bundle

使用 post、page、category、tag 选择内容类型，--title 设置标题，--use 选择模板。模板放在 archetypes/，可以按自己的写作习惯调整。