# Quick Start

Astro Editor is a desktop app for writing and editing the [Markdown](https://www.markdownguide.org/) and [MDX](https://mdxjs.com/) content in local [Astro](https://astro.build/) 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](https://astroeditor.danny.is/getting-started/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 <Kbd mac="Cmd+S" windows="Ctrl+S" />.

That's it 🥳

[Introduction to Astro Editor](https://astroeditor.danny.is/getting-started/introduction/)