# editmd

> A free Markdown editor for Mac, in preparation. Local files, optional AI review, no account.
> Product claims on this site describe the app before its first public release; no release exists yet.
> Every page has a Markdown twin at the same path with a .md extension.

## Pages

- [editmd — a free Markdown editor for Mac](https://editmd.app/index.md): Create, edit, preview and review Markdown on your Mac. A free, local editor with optional AI assistance and flexible exports.
- [Waiting list](https://editmd.app/waiting-list.md): One message when the first verified build of editmd, a free Markdown editor for Mac, is ready.
- [The editmd handbook](https://editmd.app/docs.md): Every guide for editmd, grouped by what you are trying to do.
- [What is a Markdown file?](https://editmd.app/docs/markdown.md): A small amount of syntax. A document you can take anywhere.
- [Install editmd](https://editmd.app/docs/install.md): Get the Mac app into Applications and open your first file.
- [Your first document](https://editmd.app/docs/first-document.md): Write a short note, see it take shape, and save it somewhere familiar.
- [Write and format](https://editmd.app/docs/writing.md): A practical Markdown reference for the things you write every day.
- [Files, folders and recovery](https://editmd.app/docs/workspace.md): Keep related writing together and understand where your changes live.
- [Make the editor yours](https://editmd.app/docs/preferences.md): Set comfortable type, scrolling and layout without changing your document.
- [Connect an AI model](https://editmd.app/docs/ai-setup.md): Choose a provider, add a connection and test it before using document text.
- [Your first AI request](https://editmd.app/docs/ai-use.md): Review the text you send, then decide what to keep.
- [Copy, export and share](https://editmd.app/docs/exports.md): Choose an output for the person or tool receiving your writing.
- [Update, back up and remove](https://editmd.app/docs/updates.md): Replace the app safely and understand what happens to your files.
- [Keyboard shortcuts](https://editmd.app/docs/shortcuts.md): Keep your hands on the keyboard, from the first file to the final save.
- [Troubleshooting](https://editmd.app/docs/troubleshooting.md): Find the next useful action when a file, preview or connection behaves unexpectedly.
- [How editmd is built](https://editmd.app/docs/how-it-is-built.md): A desktop shell, a source editor and a renderer around ordinary files.
- [Frequently asked questions](https://editmd.app/docs/faq.md): Practical answers about files, the app, AI and getting your work out.
- [Privacy and data handling](https://editmd.app/docs/privacy.md): Privacy notice for editmd.app and the editmd Mac app: what we collect, why, where it goes and how to reach us.
- [Changelog](https://editmd.app/docs/changelog.md): Release notes for editmd. No public release has been published yet.
- [Markdown School](https://editmd.app/learn.md): Twelve practical lessons with narrated videos, editable examples and exercises. Markdown foundations, YAML metadata and AI instruction files.
- [A small format. A lasting idea.](https://editmd.app/learn/lessons/origins.md): Meet Markdown: readable text that can become a structured document.
- [Choose the format for the work.](https://editmd.app/learn/lessons/formats.md): Use Markdown where readable, portable writing helps—and recognize when another format fits better.
- [Make a note easier to scan.](https://editmd.app/learn/lessons/headings.md): Give every idea a place with a title and section headings.
- [Turn a list into next steps.](https://editmd.app/learn/lessons/tasks.md): Write ordinary lists, ordered steps and checkable tasks.
- [Make your references useful.](https://editmd.app/learn/lessons/links.md): Connect an idea to its source with a link that tells the reader what to expect.
- [Ask for a review. Keep your judgment.](https://editmd.app/learn/lessons/review.md): Give AI a bounded task, then verify the suggestions before changing your document.
- [Read YAML as structured data.](https://editmd.app/learn/lessons/yaml-basics.md): Build named values, lists and nested settings, then separate syntax from meaning.
- [Give a document useful metadata.](https://editmd.app/learn/lessons/yaml-front-matter.md): Combine YAML and Markdown, compare literal and folded text, and check a small schema.
- [Write scoped instructions for Codex.](https://editmd.app/learn/lessons/agents-md.md): Create a concise AGENTS.md and reason about directory scope with a fictional project.
- [Make Claude project guidance checkable.](https://editmd.app/learn/lessons/claude-md.md): Replace vague instructions with concrete project facts and verify what Claude Code loads.
- [Inspect Gemini CLI context.](https://editmd.app/learn/lessons/gemini-md.md): Write GEMINI.md guidance, inspect loaded context and distinguish editing from reloading.
- [Build and test a focused skill.](https://editmd.app/learn/lessons/skill-md.md): Combine discovery metadata, a bounded procedure and positive and negative test cases.
- [Contact](https://editmd.app/contact.md): Get help with editmd, report a problem, or suggest an improvement.
- [Why we made it](https://editmd.app/about.md): Why Brencel built editmd, what it is good at, why it is free, and how to help make it better.
- [Security](https://editmd.app/security.md): How editmd and this website handle your files, your text and your data.
- [Brand guidelines](https://editmd.app/brand.md): How to write the editmd name, use the mark, and refer to the app when you link, review or sponsor it.

## Optional

- [Everything in one file](https://editmd.app/llms-full.txt)