Quick Start

Astro Editor is a desktop app for writing and editing the Markdown and MDX content in local Astro projects. It understands your content collections, so your files and their frontmatter show up ready to edit.

1. Install. Download and install the app for your platform. See Installation.

2. Open your project. Choose File > Open Project and pick your Astro project’s folder. Astro Editor scans it for content collections defined in src/content/config.ts or src/content.config.ts.

   Run astro sync first

   Astro Editor builds its frontmatter forms from the schema information Astro generates for your collections. As long as you’ve run astro sync (or astro dev / astro build) in the project at least once, that information will be there. If your fields don’t show up the way you expect, run astro sync and reopen the project.

3. Pick a collection and open a file. Your collections appear in the left sidebar. Click one to see its files, then click any file to open it. The prose opens in the main editor, and its frontmatter appears in the right sidebar.

4. Start writing. Edit your content in the middle and its metadata on the right. Changes save automatically every couple of seconds, and you can save anytime with Command + S CmdS Control + S CtrlS Command + S CmdS .

That’s it 🥳

Introduction to Astro Editor A tour of the interface and what Astro Editor needs from your project.