Skip to content

Format Customization

Markdown (.md)

Default. One file per day. YAML frontmatter (optional) plus headed sections per category.

Obsidian Bases

Markdown with structured frontmatter optimized for Obsidian's Bases plugin. Numeric properties stay numeric, dates stay dates.

JSON

One JSON file per day. Apple schema-v8 daily summaries can embed the authoritative healthmd.healthkit_records v1 archive when Lossless Health Records is enabled.

CSV

One CSV file per day with the header Date,Category,Metric,Value,Unit,Timestamp. Compatibility summary rows contain five fields and omit the timestamp column. Timestamped and canonical-record rows contain all six.

Need the exact contract?

See the production-backed format reference, CSV row contracts, and complete downloadable fixtures.

Pickers for date format (e.g. YYYY-MM-DD, MMM d, yyyy) and time format (12-hour, 24-hour). The preview block at the bottom of the screen updates live as you change settings.

Toggle between Metric and Imperial. Affects distance (m/km vs ft/mi), weight (kg vs lb), temperature (°C vs °F), and a few others. HealthKit always stores in canonical units. Conversion happens at export time.

Tapping Frontmatter Fields opens a dedicated editor:

  • Toggle individual built-in fields (date, weekday, totalSteps, etc.)
  • Rename a field, useful if your Obsidian setup expects different keys
  • Add custom fields with static values (e.g. type: health)
  • Add placeholder fields that resolve at export time (e.g. weather: {weather})

Tapping Markdown Template opens a template editor with several built-in styles (Compact, Sections, Detailed) plus a fully custom mode. The preview block shows the result for today's data.

At the bottom of the Format screen, a live preview block renders today's data with your current settings. This is the fastest way to iterate, change a toggle, look at the preview, repeat.

Summary produces compact daily projections. Detailed Time-Series adds selected timestamped samples and intervals on both Apple and Android where the metric supports them. Lossless Health Records adds the canonical HealthKit archive and is Apple-only. It is not an Android compatibility layer.

Data Detail is frozen with the rest of an export profile. Editing it while a profile is active changes that profile, not every profile on the device.