Export

The Export tab is organized as three small decisions: confirm readiness, choose a destination, then pick the date range before previewing or exporting.

Read the status badges

Health badge

Green dot = HealthKit authorized. Red = not granted. Tap to retry the iOS permission sheet (only works the first time per install — after that, iOS silently does nothing and you have to fix it in Settings → Privacy & Security → Health).

Vault badge

Green dot = a vault folder is selected. Tap to re-pick or change the vault. The label shows the folder name.

The Export action stays disabled until HealthKit, output format, and the selected destination are ready. This prevents the most common failure mode: trying to export with no destination.

Choose an export target

The Export Target card decides where files will be written:

Local iPhone Folder

Writes directly into the folder or Obsidian vault you picked on this device.

Connected Mac

Sends the export job to the nearby Mac app. The iPhone still reads HealthKit; the Mac writes the received files.

Pick a date range

Date presets cover the common paths:

Today

Export the current day. Useful for testing output formatting.

Yesterday

The safest daily-export choice because the day is complete.

All Time

Backfill from the earliest HealthKit data Health.md can find.

Custom

Pick start and end dates for a specific range.

Preview or Export

Preview

Shows the files and contents that will be generated before anything is written.

Export

Runs the export, shows progress on the main screen, and records the outcome in history.

What “exporting” actually does

1. For each day in the range, query HealthKit for every metric you've enabled.
2. Apply your chosen format (Markdown, Bases, JSON, or CSV) and template.
3. Write one file per day into {vault}/{subfolder}/ or send the job to the connected Mac.
4. If Individual Tracking is on, also write one file per timestamped entry into the entries folder.
5. If Daily Note Injection is on, also merge metrics into your daily notes' frontmatter.

Tab bar

The four tabs at the bottom of the screen — Export, Schedule, Sync, Settings — cover the entire app surface area. Everything else lives one or two layers deep inside Settings.

Unlock behavior.

Full Access unlocks unlimited export runs, scheduled exports, Mac destinations, and Shortcuts. See the Paywall page for details.

Related

Daily useScheduling — automate this so you never tap Export again. CustomizeFormat Customization — change what each file looks like. PowerShortcuts — trigger exports from Siri, automations, or other apps.