Workflow

Taking Markdown notes on iPhone

How to make Markdown practical on iPhone, from quick capture and editing to files, syncing, and export.

An iPhone note often begins in a few spare seconds. A good Markdown workflow makes capture fast enough that you will actually use it, then leaves enough structure for the note to make sense later.

Start with the capture path

Try creating a note from the place you will really be: on a walk, between meetings, or from a share sheet. A heading can wait. One sentence and a short list are often enough. When you return, add structure with headings, links, or checkboxes.

On a small screen, editing controls should help rather than crowd the text. Look for sensible selection behavior, comfortable list continuation, and an easy way to get back to ordinary typing. If an editor offers live formatting, check that you can still inspect and change the underlying Markdown.

Decide how files move

If you keep .md files in iCloud Drive, use the Files app to check that the folder and documents are visible, and test opening one in another compatible editor. If your notes app uses an internal store, test its export path instead. The two workflows are different even when both use iCloud. See Markdown notes and iCloud.

Images need special attention. A Markdown image reference points to a resource; it does not usually embed the pixels in the .md text. When you move a note, move the image too and check the link. Our attachments guide explains the common patterns.

A simple mobile routine

  1. Capture the thought in one note, without organizing first.
  2. Add a short heading or useful title when you have a moment.
  3. Use lists for actions and plain paragraphs for context.
  4. Review or export a few notes periodically, especially if the app stores them internally.

Markdown does not need to make every note look like a document. Its value on iPhone is that a quick line of text can grow into something structured without losing its readable source.

First-party example: Ember Notes is made by this site's publisher and offers live Markdown editing on iPhone and iPad. It stores notes in an app-managed SwiftData and CloudKit system and supports Markdown export.