323 words
1 minute
撰写博客文章
本博客模板基于 Astro 构建。本文是一个简短的通用示例，展示一篇文章的文件结构与常用 frontmatter。完整的最新 schema 与 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---| Attribute | Description |
|---|---|
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 这样的相对图片路径，会从当前文章文件所在位置开始解析。
Share
If this article helped you, please share it with others!
Some information may be outdated
Related Posts Smart
1
Markdown 扩展功能
教程 Mizuki 中的 GitHub 卡片、提示框、代码组、Wiki 链接、图片网格、PlantUML 等增强 Markdown 功能。
2
Markdown 教程
教程 一个 Markdown 博客文章的简单示例。
3
Markdown 与 Mermaid 图表
教程 一篇包含 Mermaid 图表的 Markdown 博客文章简单示例。
4
图片画廊网格：语法与完整示例
教程 一份关于图片画廊网格的语法、参数、裁剪、响应式行为、图注与灯箱导航的完整指南。
5
MDX 语法指南
教程 了解如何在 MDX 文章中组合 Markdown、组件、JavaScript 表达式、提示框、Wiki 链接、数学公式、代码组和图片。