Skip to content
Air
zh

Guide

Author Guoqi Sun Filed under Guides· 2 min read· Updated · Last modified

Configure the site

Edit src/config.ts to set the title, default author, localized site description, favicon files, canonical URL, locales, page size, handwriting font, and navigation. The description is shared by the homepage, SEO metadata, and RSS; favicon paths point to files in public/. A post-level author overrides the default author. Navigation accepts built-in page names or external links with localized labels.

Add content

Posts live in src/content/blog/<locale>/; standalone pages live in src/content/pages/<locale>/. Give translations the same filename. Development shows draft: true entries for preview, while production excludes them.

title: A post title
description: A short summary.
author: Optional author
pubDate: 2026-11-14
updatedDate: 2026-11-15
draft: true
pin: 1
category: Notes
tags: [Astro, Writing]

title, description, and pubDate are required. The other fields are optional. Set pin from 1 to 99 to keep a post at the top of the home list; a higher number stays above a lower one. Omit it, or use 0, to leave the post in date order.

Write Markdown and MDX

Use .md for ordinary Markdown and .mdx when a post needs components. Import an Astro component, then use it like markup:

import Callout from '../../../components/content/Callout.astro'

<Callout title="A useful aside">MDX can render an Astro component.</Callout>

Components render to static HTML by default. Add client:* only when browser-side interaction is required. Preview with astro dev --background, inspect failures with astro dev logs, and run the project checks plus a production build before publishing.