health.md icon health.md
Core Feature

Export

The Export tab is the main canvas. It shows whether HealthKit and your vault are connected, exposes a single Export button, and gives you a date-range modal for one-off exports.

Export tab
Export tab

The two 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 Health Data button is disabled until both badges are green. This prevents the most common failure mode: trying to export with no destination.

The export modal

Export modal — full
Export modal — full

Tapping Export Health Data opens this modal. From here you control:

Vault & subfolder

Confirms where files will land. The subfolder field is editable; saved per-export.

Start date

The first day to export. Defaults to one week ago.

End date

The last day to export, inclusive. Defaults to today.

Export

Runs the export. Closes the modal and shows a progress bar on the main screen, then a toast with the result.

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}/.
  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.

Free trial limit.

Free users get 3 full exports. After that, tapping Export opens the paywall. See the Paywall page for what unlocks change.

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.