201 words
1 minute
Writing a Blog Post
This blog template is built with Astro. This article is a small, generic example of the file structure and common frontmatter used by a post. The complete current schema and Markdown syntax are maintained in the Content Authoring Guide.
Common 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 | The title of the post. |
published | The date the post was published. |
pinned | Whether this post is pinned to the top of the post list. |
priority | The priority of the pinned post. Smaller value means higher priority (0, 1, 2…). |
description | A short description of the post. Displayed on index page. |
image | The cover image path of the post. 1. Start with http:// or https://: Use web image2. Start with /: For image in public dir3. With none of the prefixes: Relative to the markdown file |
tags | The tags of the post. |
category | The category of the post. |
licenseName | The license name for the post content. |
author | The author of the post. |
sourceLink | The source link or reference for the post content. |
draft | If this post is still a draft, which won’t be displayed. |
Where to Place the Post Files
Place post files in src/content/posts/. You can create sub-directories to organize articles and their local assets.
src/content/posts/├── example.md└── guides/ ├── cover.webp └── index.mdRelative images such as ./cover.webp are resolved from the current article file.
Share
If this article helped you, please share it with others!
Writing a Blog Post
https://mizuki.mysqil.com/posts/guide/ Some information may be outdated
Related Posts Smart
1
MDX Syntax Guide
Guides Learn how to combine Markdown, components, JavaScript expressions, callouts, Wiki Links, math, code groups, and images in an MDX article.
2
Markdown Extended Features
Examples GitHub cards, callouts, code groups, Wiki Links, image grids, PlantUML, and other enhanced Markdown features in Mizuki.
3
Image Gallery Grid: Syntax and Complete Examples
Examples A complete guide to image gallery grid syntax, parameters, cropping, responsive behavior, captions, and lightbox navigation.
4
Include Video in the Posts
Examples This post demonstrates how to include embedded video in a blog post.
5
Markdown Tutorial
Examples A simple example of a Markdown blog post.