Skip to content

Frontmatter

Frontmatter is the YAML block at the top of each Markdown file, between --- lines. Astro and your theme read it for title, dates, SEO, images, and drafts.

Creating a note with Ctrl/Cmd + N (with Astro Composer configured) may insert a template like:

---
title: "{{title}}"
date: {{date}}
description: ""
tags: []
image: ""
imageAlt: ""
imageOG: false
hideCoverImage: false
hideTOC: false
targetKeyword: ""
draft: true
---

Placeholders depend on your content type and Astro Composer settings.

FieldTypeNotes
titlestringPage title and often the <title> tag.
datestringOften YYYY-MM-DD; used for sorting, RSS, and display.
descriptionstringMeta description; aim for ~150–160 characters for SEO.
tagsstring[]e.g. tags: [astro, tutorial]
imagestringCover image URL or vault-relative path.
imageAltstringAlt text for the cover image.
imageOGbooleanIf true, use cover image for Open Graph / social previews.
hideCoverImagebooleanHide cover on the page while still using it for OG/SEO if configured.
hideTOCbooleanHide table of contents where the theme supports it.
targetKeywordstringPrimary keyword for the SEO plugin.
draftbooleantrue keeps content out of production builds when the theme respects it.

Astro Composer: Standardize Properties (command palette) can align fields across files.

Astro Composer: Convert Wikilinks to Astro rewrites [[links]] to Markdown Astro can resolve.

Default is often YYYY-MM-DD. Adjust in Settings → Astro Composer if your theme expects another format.