---
title: "The editmd handbook"
description: "Every guide for editmd, grouped by what you are trying to do."
canonical: https://editmd.app/docs/
markdown: https://editmd.app/docs.md
status: pre-release, waiting list open
generated: editmd-website
---

# The editmd handbook

Learn Markdown, find your way around editmd, and connect an AI model when you want one.

## Start here

- [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.

## Using editmd

- [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.
- [Copy, export and share](https://editmd.app/docs/exports.md): Choose an output for the person or tool receiving your writing.

## Optional AI

- [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.

## Reference

- [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.