Connect Apple Health
Grant only the HealthKit categories you want to export from iPhone, Apple Watch, and connected apps.
Health.md writes your activity, sleep, heart, and workout data to Markdown, Obsidian Bases, CSV, or JSON — without accounts, servers, or subscriptions.
Start free. Upgrade once for unlimited exports, scheduled runs, local Mac destinations, and Shortcuts automation.
steps: 12642sleep_total_hours: 7.31workout_count: 1type: health-data
Health.md is an export layer, not another dashboard. It reads HealthKit on your Apple device and writes plain files to destinations you control.
Grant only the HealthKit categories you want to export from iPhone, Apple Watch, and connected apps.
Select metrics, date ranges, filenames, folders, and any mix of Markdown, Obsidian Bases, CSV, and JSON.
Inspect values, metric names, units, and destination paths before Health.md writes the export.
Save to Files, iCloud Drive, an Obsidian vault, a file provider, or a nearby Mac on your local network.
One HealthKit snapshot can become multiple file types in one export. Keep readable daily notes beside structured data without changing tools.
Daily summaries with optional YAML frontmatter, category sections, workout tables, and templates.
Frontmatter-first notes designed for Obsidian Bases, properties, and database-style views.
Daily payloads grouped by health category, with timestamps for granular samples when available.
Rows shaped for spreadsheets, notebooks, scripts, and downstream reporting workflows.
---
date: 2026-06-12
type: health-data
units: metric
steps: 12642
active_calories: 604
sleep_total_hours: 7.31
average_heart_rate: 68
workout_count: 1
---
# Health Data - 2026-06-12
## Sleep
- Total Sleep: 7.31 hours
- In Bed: 7.82 hours
## Activity
- Steps: 12,642
- Active Calories: 604 kcal
- Exercise Minutes: 52
## Heart
- Average Heart Rate: 68 bpm
- Resting Heart Rate: 54 bpm
## Workouts
| Time | Type | Duration | Distance |
| --- | --- | ---: | ---: |
| 7:14 AM | Outdoor Run | 42 min | 4.8 mi |
{
"schema": "healthmd.health_data",
"schemaVersion": 3,
"date": "2026-06-12",
"type": "health-data",
"units": "metric",
"activity": {
"steps": {
"value": 12642,
"unit": "count"
},
"activeCalories": {
"value": 604,
"unit": "kcal"
},
"exerciseMinutes": {
"value": 52,
"unit": "min"
}
},
"sleep": {
"totalDuration": {
"value": 26316,
"unit": "seconds",
"display": "7.31 hours"
}
},
"heart": {
"averageHeartRate": {
"value": 68,
"unit": "bpm"
}
},
"workouts": [
{
"start": "2026-06-12T07:14:00-07:00",
"type": "outdoor_run",
"durationMinutes": 42,
"distanceMiles": 4.8
}
]
}
Date,Category,Metric,Value,Unit,Start,End,Source
2026-06-12,Activity,Steps,12642,count,2026-06-12T00:00:00-07:00,2026-06-12T23:59:59-07:00,Apple Watch
2026-06-12,Activity,Active Calories,604,kcal,2026-06-12T00:00:00-07:00,2026-06-12T23:59:59-07:00,Apple Watch
2026-06-12,Activity,Exercise Minutes,52,min,2026-06-12T00:00:00-07:00,2026-06-12T23:59:59-07:00,Apple Watch
2026-06-12,Sleep,Total Sleep,7.31,hours,2026-06-11T22:46:00-07:00,2026-06-12T06:05:00-07:00,iPhone
2026-06-12,Heart,Average Heart Rate,68,bpm,2026-06-12T00:00:00-07:00,2026-06-12T23:59:59-07:00,Apple Watch
2026-06-12,Workout,Outdoor Run Duration,42,min,2026-06-12T07:14:00-07:00,2026-06-12T07:56:00-07:00,Apple Watch
2026-06-12,Workout,Outdoor Run Distance,4.8,mi,2026-06-12T07:14:00-07:00,2026-06-12T07:56:00-07:00,Apple Watch
---
schema: healthmd.health_data
schema_version: 3
date: 2026-06-12
type: health-data
tags:
- healthmd
- daily-health
steps: 12642
active_calories: 604
exercise_minutes: 52
sleep_total_hours: 7.31
sleep_in_bed_hours: 7.82
average_heart_rate: 68
resting_heart_rate: 54
workout_count: 1
workout_details:
- start: 2026-06-12T07:14:00-07:00
type: outdoor_run
duration_minutes: 42
distance_miles: 4.8
active_calories: 431
---
# 2026-06-12 Health Summary
This note is frontmatter-first so Obsidian Bases can filter,
sort, and chart properties like `steps`, `sleep_total_hours`,
and `workout_details` without changing the file format.
Use Health.md as a controlled bridge between Apple Health and a folder-based personal knowledge system.
Merge selected metrics into existing daily note frontmatter and replace app-managed body sections when needed.
Create timestamped Markdown files for workouts, mood logs, vitals, medications, and event-like metrics.
Use placeholders such as {date}, {year}, {month}, {weekday}, {monthName}, and {quarter} to match your vault.
Open the dedicated visualization lab to pick chart types, tune colors, test Obsidian-style widths, and copy ready-to-use health-viz blocks.
Drop a block into a note, change the visualization type, and Health.md turns exported HealthKit data into charts inside your vault.
```health-viz
type: activity-rings
to: 2026-05-17
last: 1
height: 320
theme: auto
colorScheme: theme
moveGoal: 650
exerciseGoal: 45
standGoal: 12
```
activity-rings
The iPhone remains the HealthKit source. The Mac app acts as a local destination, writes files to a folder you choose, and keeps export history near your desktop workflow.
iPhone-configured export jobs travel to the Mac over nearby-device connectivity. No health-data cloud account is required.
Write to folders that only exist on your Mac, including local Obsidian vaults and analysis directories.
Export, sync status, schedule, settings, and history live in the Mac app with menu bar access.
Read the feature guide, inspect the metric reference, and check release notes before giving Health.md access to sensitive HealthKit categories.
Onboarding, exports, scheduling, Mac sync, Shortcuts, daily notes, individual tracking, and paywall behavior.
Metric IDs, HealthKit identifiers, units, aggregations, frontmatter keys, CSV shape, JSON shape, and Bases output.
Announcements and workflow articles for Health.md features, app updates, and Obsidian health-data systems.
Short answers for questions people ask before installing a health-data export tool.
No. Health.md does not run a health-data cloud service, require an account, or collect analytics. HealthKit reads happen on your Apple devices. Exported files may sync only through destinations you choose.
Full Access unlocks unlimited exports, scheduled exports, Mac destination workflows, and Shortcuts support. It is a one-time in-app purchase handled by StoreKit.
Use Restore Purchase from the app’s paywall or settings. StoreKit restores the Full Access transaction tied to your Apple ID.
Yes, when that data is already in Apple Health and you grant Health.md permission for the relevant categories.
No. Obsidian daily notes and Bases are supported, but Health.md also exports standard Markdown, CSV, and JSON files.
Yes. Choose only the formats you want for each export. Markdown and Obsidian output are optional.
The iPhone remains the HealthKit source. The Mac app acts as a local destination over nearby-device connectivity and writes files into the folder you choose.
No. iOS background refresh is opportunistic, so the scheduled time is a target. Health.md uses local notifications as a fallback when manual action is needed.
No. Health.md is a data export tool, not a medical device, diagnosis tool, healthcare provider, or emergency service.
App Store purchases and refunds are handled by Apple through the App Store refund process.
Download Health.md for free, choose the metrics that matter, preview the files, and unlock Full Access once when you are ready for unlimited exports.