328 字
1 分钟
撰写博客文章
该博客模板基于 Astro 构建。本文是一个简短的通用示例，介绍文章的文件结构以及文章常用的 frontmatter。完整的当前架构和 Markdown 语法维护在 内容编写指南 中。
常用 frontmatter
---title: "An Example Article"published: 2026-08-01updated: 2026-08-08description: "A short summary for previews."image: ./cover.webptags: [Example, Guide]category: Guidesdraft: falsecomment: true---| 属性 | 描述 |
|---|---|
title | 文章标题。 |
published | 文章发布的日期。 |
pinned | 该文章是否置顶在文章列表顶部。 |
priority | 置顶文章的优先级。数值越小，优先级越高（0、1、2……）。 |
description | 文章的简短描述。显示在索引页上。 |
image | 文章封面图片的路径。 1. 以 http:// 或 https:// 开头：使用网络图片2. 以 / 开头：使用 public 目录中的图片3. 不带上述前缀：相对于 Markdown 文件的路径 |
tags | 文章的标签。 |
category | 文章的分类。 |
licenseName | 文章内容的许可证名称。 |
author | 文章作者。 |
sourceLink | 文章内容的来源链接或参考资料。 |
draft | 该文章是否仍处于草稿状态；处于草稿状态的文章不会显示。 |
将文章文件放置在哪里
将文章文件放在 src/content/posts/ 中。你可以创建子目录来整理文章及其本地资源。
src/content/posts/├── example.md└── guides/ ├── cover.webp └── index.md相对图片路径（例如 ./cover.webp）会从当前文章文件所在位置解析。
分享
如果这篇文章对你有帮助，欢迎分享给更多人！
部分信息可能已经过时
相关文章 智能推荐
1
MDX 语法指南
指南 了解如何在 MDX 文章中结合使用 Markdown、组件、JavaScript 表达式、提示框、Wiki 链接、数学公式、代码组和图片。
2
Markdown 扩展功能
示例 GitHub 卡片、提示框、代码组、Wiki 链接、图片网格、PlantUML 以及 Mizuki 中的其他增强 Markdown 功能。
3
图片画廊网格：语法与完整示例
Examples 图片画廊网格语法、参数、裁剪、响应式行为、图片说明及灯箱导航的完整指南。
4
Markdown 教程
Examples 一个简单的 Markdown 博客文章示例。
5
Markdown Mermaid
Examples 使用 Mermaid 在 Markdown 文档中创建复杂图表的简单示例。