Astro Editor

A native macOS markdown editor for Astro content collections. Clean writing interface with automatic frontmatter editing based on your collection schemas.

https://github.com/user-attachments/assets/dc32dd12-2094-47c4-ab90-620ecd11ba48

Features

Writing Environment

• Clean markdown/MDX editor with syntax highlighting. Frontmatter and imports are hidden while editing, shown in a dedicated sidebar.
• Focus mode (highlights current sentence), copyedit mode (highlights parts of speech), and typewriter mode (keeps the cursor centered on screen).
• Customizable heading colors with separate settings for dark and light themes.
• Image preview on hover (Option + hover over paths).
• Comprehensive keyboard shortcuts for formatting, headings, and navigation.
• Auto-save: saves 2 seconds after you stop typing (configurable) with backup saves every 10 seconds while typing. Crash recovery included.

Frontmatter & Schema Integration

• Generates editing forms from your Astro collection schemas with proper validation.
• Supports all Zod types: strings, numbers, dates, booleans, enums, arrays, nested objects, references, and image fields.
• Image fields provide drag-and-drop with automatic copying to your assets directory using relative paths by default (configurable per project/collection).
• Field constraints (min/max, character limits) enforced in the UI.

MDX Components

• Cmd + / opens component builder showing all components in your src/components/mdx/ directory.
• Supports Astro, React, Vue, and Svelte components.
• Automatically detects available props and lets you tab through values after insertion.

File Management

• Collections and files automatically discovered from your content.config.ts.
• Full support for subdirectories within collections.
• Files sorted by publication date (configurable field name) with draft indicators.
• Context menu for rename, duplicate, reveal in Finder, copy path.
• Command palette (Cmd + P) for quick file switching and command access.

Project Configuration

• Per-project and per-collection settings for custom directory structures.
• Configurable field mappings (title, date, draft, description fields).
• Light/dark theme with system integration.
• IDE integration (open files/projects in VSCode, Cursor, etc.).

Documentation

• [Documentation](https://astroeditor.danny.is/getting-started/) - Complete feature documentation
• [Contributing](docs/CONTRIBUTING.md) - Development setup and guidelines