类型 Template
创建 Jan 01, 2026, 00:00:00 / 更新 Jun 19, 2026, 21:15:14
字数 596
返回博客
欢迎使用 Astro-star
一篇入门博客文章，展示长文写作的基本用法。
欢迎使用 Astro-star
这是一篇占位博客文章。Fork 仓库后请替换为你自己的内容。
Astro-star 支持内容集合、MDX、RSS、站点地图、项目页面、笔记、友链和可选的站内搜索。你可以保持现有结构，专注于写作。
如果你是 Astro 新手，建议先阅读 Astro 官方文档，然后替换这篇文章。
建议修改
- 在
src/config/site.ts中更新你的名字、域名、社交链接和站点描述。 - 替换
src/content/blog、src/content/note和src/content/project中的文件。 - 需要本地图片时，将图片放入
public/figures。
MDX 示例
你可以像往常一样编写 Markdown，后续如果需要更丰富的文章组件，可以添加 MDX 组件。
引用块可以用来突出一段简短的摘录、旁注或来源说明。
本模板包含什么
Astro-star 从个人网站通常需要的基本部分开始：首页介绍作者，文章区域收集长文和笔记，项目区域给工具和实验独立空间，友链页面将友情链接与主要内容分开。
目标不是把所有网站套进同一个结构，而是给你一个干净的起点，让你先替换占位内容，再根据实际写作需求调整设计。
内容集合
博客、笔记和项目存放在 Astro 内容集合中。每个文件有 frontmatter 来定义路由 slug、标题、描述、创建日期和可选的特定字段。
站点配置
站点配置控制名称、链接、导航、评论、文章操作和视觉默认值。从编辑 src/config/site.ts 开始，然后更新内容文件。
写作流程
要写新文章，在 src/content/blog 下创建一个 MDX 文件。选择一个稳定的 routeSlug，添加简短描述，设置 createdAt，然后用普通 Markdown 写作。构建过程会自动收集文章、生成归档页面并包含在 RSS 中。
本地预览
写作时运行开发服务器，可以尽早发现排版问题。长标题、宽表格、重复图片、代码块和嵌套列表是通常需要调整的地方。
发布前检查
发布前检查生成的文章页面、归档页面和 RSS 输出。也值得在窄视口下打开页面，检查移动端导航和目录行为。