Generated Markdown and frontmatter
The shape of the Markdown file Acrosite generates for a content item — the frontmatter keys, the SEO block, Custom Field values, and the body — previewed before publishing.
When a content item publishes, Acrosite generates a Markdown file with frontmatter — a block of structured metadata at the top — followed by the body. The editor can preview this exact shape before anything is published, so you always know what your site will receive.
Preview the output
In the editor, open Advanced Output Details and expand Generated Markdown / MDX Source. Acrosite shows the file it would generate from the current draft: the frontmatter, then the body. This preview updates as you edit, so you can confirm the output before review or publishing.
The frontmatter shape
A typical Post generates frontmatter like this:
---
title: "Welcome to our site"
slug: "welcome"
status: "draft"
excerpt: "A short summary that orients the reader."
seo:
title: ""
meta_description: ""
canonical_url: ""
noindex: false
fields:
category: ["guides"]
featured: "no"
---The keys you will see:
- title and slug — from the content details.
- status — the item's current workflow status.
- excerpt — the optional short summary.
- seo — the nested SEO fields: title, meta description, canonical URL, and noindex.
- fields — your Custom Field values, each under its field key.
The body and images
Below the frontmatter, the body is written as Markdown. Headings appear as #, ##, and ###; the Block Editor's blocks output standard Markdown, and MDX blocks are kept as trusted source text. A body image appears as a standard Markdown image with optional alt text and title, and a caption is written beneath it:
Your body text in Markdown.
_An optional caption._Why the preview matters
Because the output is generated, you can design your site templates against a known, stable shape. Custom Field values use each field's key, SEO lives under the seo block, and images reference clean /images/... paths. See Where media lands in your repository for image paths and Acrosite-managed content paths for the folder layout.