Visualizations & Roadmap

Health.md exports a schema-versioned local data set for Markdown, Obsidian Bases, JSON, and CSV. This roadmap connects the data to the Obsidian visualization plugin. It shows current visualizations, possible additions, and categories that need generic schema-aware charts.

Data source.

This page follows Health.md's export schema and data dictionary. It covers activity, sleep, heart, vitals, body, nutrition, mindfulness, medications, and workouts. It also covers reproductive health, symptoms, hearing, and lifestyle or environment metrics.

Per-visualization unit overrides

Set units inside an individual health-viz block when one chart should use a different display system than the plugin-wide preference:

type: workout-trends
metric: distance
units: imperial

Use auto to follow the unit system in the export. Use metric for kilometers, kilograms, meters, and Celsius. Use imperial for miles, pounds, feet, and Fahrenheit. The override applies only to that visualization. It takes precedence over the global Units setting. It changes display values only. The exported Health.md files remain unchanged. Non-convertible metrics such as steps, BPM, percentages, and calories do not change.

Current visualization coverage

43plugin renderers today

18export data categories

220+canonical export keys

1generic metric layer still needed

Platform support by exporter

Visualization support depends on whether the source data exists in both Apple HealthKit and Android Health Connect, or only in the Apple HealthKit export contract.

iOS and Android

These visualizations map to shared HealthKit / Health Connect export fields:

Category	Visualization types
Overview	`intro-stats`, `summary-card`, `trend-tile`
Activity	`activity-rings`, `vitals-rings`, `bar-chart`, `activity-heatmap`, `step-spiral`, `weekday-average`
Heart	`heart-terrain`, `heart-range`, `hrv-trend`
Respiratory and vitals	`oxygen-river`, `oxygen-range`, `breathing-wave`
Sleep	`sleep-schedule`, `sleep-quality-bars`, `sleep-architecture`, `sleep-polar`
Mobility	`walking-symmetry`*
Workouts	`workout-log`, `workout-heart-rate`, `workout-zones`, `workout-trends`, `workout-intervals`, `workout-map`

Notes:

walking-symmetry is partial on Android: Android has walking speed, but not Apple-only asymmetry or double-support details.
activity-rings is partial on Android for Stand: the plugin falls back to a steps-derived stand proxy when standHours is missing.
Workout route and sample charts require granular workout data and route permission/consent.

iOS-only

HealthKit State of Mind / mood visualizations:

mood-trend / state-of-mind
mood-calendar-heatmap
mood-sleep-scatter
mood-day-timeline
mood-association-breakdown
mood-label-cloud
mood-volatility
mood-kind-split
mood-circadian-clock
mood-recovery-tile
mood-association-matrix

Medication catalog / dose-event visualizations:

medication-overview / medications / medication-adherence
medication-inventory
medication-adherence-summary
medication-dose-status / per-medication-dose-status
medication-adherence-trend / medication-daily-adherence-trend
medication-recent-dose-events / medication-dose-events

Android Health Connect does not expose equivalent HealthKit State of Mind records or HealthKit-style medication catalog / dose-event records.

Android-only

None in the current Obsidian plugin visualization registry. Android does export Android-native data such as PHR/FHIR resources, planned workouts, and activity intensity, but no current visualization type targets those fields yet.

Visualization catalog

Each item links to its matching public variation in the Health.md visualization gallery. These links use the theme-colors variation so the docs stay fast and stable instead of embedding every renderer on this page.

Summary and overview

Intro stats, intro-stats
Summary card, summary-card
Trend tile, trend-tile

Activity

Activity rings, activity-rings
Bar chart, bar-chart
Activity heatmap, activity-heatmap
Step spiral, step-spiral
Weekday average, weekday-average

Heart

Heart terrain, heart-terrain
Heart range, heart-range
HRV trend, hrv-trend

Respiratory, oxygen, and vitals

Oxygen river, oxygen-river
Oxygen range, oxygen-range
Breathing wave, breathing-wave
Vitals rings, vitals-rings

Sleep

Sleep schedule, sleep-schedule
Sleep quality bars, sleep-quality-bars
Sleep architecture, sleep-architecture
Sleep polar, sleep-polar

Mindfulness and mood

Mood trend, mood-trend
Mood calendar heatmap, mood-calendar-heatmap
Mood × sleep scatterplot, mood-sleep-scatter
Mood day timeline, mood-day-timeline
Mood by association, mood-association-breakdown
Mood label cloud, mood-label-cloud
Mood volatility, mood-volatility
Daily vs momentary mood, mood-kind-split
Circadian mood clock, mood-circadian-clock
Recovery + mindset tile, mood-recovery-tile
Mood association matrix, mood-association-matrix

Medications

Medication overview, medication-overview
Medication inventory, medication-inventory
Medication adherence summary, medication-adherence-summary
Medication dose status, medication-dose-status
Medication adherence trend, medication-adherence-trend
Medication recent dose events, medication-recent-dose-events

Mobility, gait, and running form

Walking symmetry, walking-symmetry

Workouts

Workout log, workout-log
Workout heart rate, workout-heart-rate
Workout zones, workout-zones
Workout trends, workout-trends
Workout intervals, workout-intervals
Workout map, workout-map

Foundation roadmap

The biggest product gap is not one missing chart. It is a generic schema-aware metric layer that lets any exported Health.md field be plotted without writing a custom parser and renderer for every metric.

Built

Schema compatibility detection for daily exports, legacy files, rollups, and data dictionary files.
JSON, CSV, Markdown, and Obsidian Bases loading.
Rollup awareness so weekly/monthly/yearly summaries do not pollute daily charts.
Source-file navigation from chart points back to the contributing Health.md file.

Planned

Generic schema-aware metric accessor, read _healthmd_data_dictionary.json for labels, units, categories, aggregation rules, and aliases.
Generic metric trend, line/area chart for any numeric exported key.
Generic metric bars, generalized daily/weekly/monthly bars with goal and threshold lines.
Generic calendar heatmap, any daily numeric metric as a calendar grid.
Visualization coverage report, show fields present in a vault vs fields covered by dedicated renderers.

Summary and overview

Built

intro-stats, dataset summary with totals, averages, sleep, and vitals.
summary-card, Apple-style KPI card with sparkline and prior-period comparison.
trend-tile, trends-card comparison between current and prior windows.

Planned

Auto-generated dashboard based on fields present in the selected Health.md folder.
Schema coverage dashboard by data category.
Correlation summary cards, such as sleep vs mood, HRV vs workouts, symptoms vs medications, or alcohol vs sleep.

Activity

Health.md exports steps, active energy, basal energy, exercise time, stand time, flights climbed, and walking/running distance. It also exports cycling, swimming, wheelchair activity, downhill snow distance, move time, physical effort, and VO₂ max.

Built

Planned

Activity load dashboard for steps, calories, exercise, stand hours, and physical effort.
VO₂ max trend.
Move / exercise / stand consistency chart.
Distance mix chart across walking/running, cycling, swimming, wheelchair, and snow sports.
Swimming distance + stroke chart.
Wheelchair distance + push chart.

Sleep

Health.md exports total sleep, bedtime, wake time, deep/REM/core/awake/in-bed durations, and granular sleep-stage intervals.

Built

Planned

Sleep debt and consistency score.
Sleep stage ratio trend.
Bedtime/wake regularity heatmap.
Sleep + HRV + resting heart rate recovery dashboard.

Heart

Health.md exports resting heart rate, walking heart rate, average/min/max heart rate, HRV, heart-rate samples, HRV samples, heart-rate recovery, and AFib burden.

Built

Planned

Resting heart-rate trend.
Walking heart-rate trend.
Heart-rate recovery trend.
AFib burden chart.
HRV + resting heart rate recovery tile.
Circadian heart-rate profile by time of day.

Respiratory and oxygen

Health.md exports blood oxygen average/min/max, blood oxygen samples, respiratory-rate average/min/max, and respiratory-rate samples.

Built

Planned

Dedicated respiratory range chart.
Oxygen desaturation event chart.
Overnight respiratory dashboard combining sleep stages, oxygen, and respiratory rate.

Vitals

Health.md exports body temperature, blood pressure, blood glucose, basal body temperature, wrist temperature, electrodermal activity, forced vital capacity, FEV1, peak expiratory flow, and inhaler usage.

Built

Partial coverage through summary cards and generic daily charts.

Planned

Blood pressure systolic/diastolic range chart with threshold bands.
Blood glucose range chart.
Body, basal, and wrist temperature trend.
Wrist temperature recovery / illness tile.
Respiratory function dashboard for FVC, FEV1, peak flow, and inhaler usage.
Electrodermal activity / stress trend.

Body measurements

Health.md exports weight, height, BMI, body fat percentage, lean body mass, and waist circumference.

Built

No dedicated body composition renderer yet.

Planned

Body composition dashboard.
Weight trend with rolling average and goal line.
BMI trend with category bands.
Body fat vs lean mass chart.
Waist circumference trend.

Mobility, gait, and running form

Health.md exports walking speed, step length, double support, walking asymmetry, stair ascent/descent speed, six-minute walk, and walking steadiness. It also exports running speed, running stride length, ground contact time, vertical oscillation, and running power.

Built

walking-symmetry

Planned

Gait dashboard.
Walking steadiness gauge.
Six-minute walk trend.
Stair ascent/descent speed chart.
Running form dashboard for speed, stride, ground contact, vertical oscillation, and power.

Workouts

Health.md exports workout counts, minutes, calories, distance, workout types, heart-rate statistics, and running/cycling form metrics. It also exports power, elevation, laps, splits, route points, heart-rate zones, and workout time-series samples.

Built

Planned

Workout calendar heatmap.
Training load chart from duration and intensity.
Weekly workout distribution by type.
Pace and speed trend by workout type.
Elevation gain/loss trend.
Route comparison small multiples.
Power curve / best efforts.
Running form and cycling performance dashboards.

Mindfulness and mood

Health.md exports mindful minutes, mindful sessions, State of Mind entries, average valence, daily mood, momentary emotions, labels, and associations.

Built

Planned

Mindful minutes trend.
Mindful session streak/calendar.
Mood vs medication adherence.
Mood vs nutrition, alcohol, and caffeine.
Mood label timeline.

Medications

Health.md exports medication inventory, active/archived counts, dose event counts, taken/skipped counts, medication details, RxNorm/coding metadata, dose quantities, schedule type, scheduled/start/end dates, statuses, and metadata.

Built

Planned

Medication schedule timeline.
Medication adherence calendar heatmap.
Medication lateness chart comparing scheduled time to taken time.
Dose quantity trend.
Medication vs symptom/mood correlation views.
RxNorm / coding detail panel.

Nutrition

Health.md exports dietary calories, protein, carbohydrates, fat, saturated fat, monounsaturated fat, polyunsaturated fat, fiber, sugar, sodium, cholesterol, water, and caffeine.

Built

No dedicated nutrition renderer yet.

Planned

Nutrition dashboard.
Macro split chart.
Calories in vs active calories chart.
Hydration trend.
Caffeine daily amount / timing chart.
Sugar and sodium threshold charts.
Fiber and protein goal progress.

Vitamins and minerals

Health.md exports vitamins A, B6, B12, C, D, E, and K. It also exports thiamin, riboflavin, niacin, folate, biotin, and pantothenic acid. Exported minerals include calcium, iron, potassium, magnesium, phosphorus, zinc, selenium, copper, manganese, chromium, molybdenum, chloride, and iodine.

Built

No dedicated micronutrient renderer yet.

Planned

Micronutrient heatmap.
Recommended daily value progress grid.
Vitamin trend dashboard.
Mineral trend dashboard.
Deficiency/excess flag panel.
Nutrition completeness score.

Hearing

Health.md exports headphone audio level and environmental sound level.

Built

Partial summary-level coverage only.

Planned

Hearing exposure trend.
Loud-day calendar.
Safe exposure threshold bands.
Weekly exposure summary.

Reproductive health and cycle tracking

Health.md exports menstrual flow, sexual activity, ovulation test result, cervical mucus quality, and intermenstrual bleeding.

Built

No dedicated reproductive health renderer yet.

Planned

Cycle calendar.
Menstrual flow heatmap.
Fertility signal timeline.
Cycle symptom overlay combining reproductive health, symptoms, mood, and sleep.
Spotting / intermenstrual bleeding timeline.

Symptoms

Health.md exports daily counts for headache, fatigue, nausea, dizziness, mood changes, sleep changes, appetite changes, hot flashes, chills, and fever. It also exports lower back pain, bloating, constipation, diarrhea, heartburn, coughing, sore throat, runny nose, and shortness of breath. Other counts cover chest pain, skipped heartbeat, rapid heartbeat, acne, dry skin, hair loss, memory lapse, night sweats, and vomiting. They also cover abdominal cramps, breast pain, pelvic pain, body ache, fainting, loss of smell, loss of taste, and wheezing. The remaining counts cover sinus congestion, bladder incontinence, and vaginal dryness.

Built

No dedicated symptom renderer yet.

Planned

Symptom calendar heatmap.
Symptom frequency leaderboard.
Symptom co-occurrence matrix.
Flare timeline.
Symptom correlation explorer.
Body-system grouped symptom dashboard.

Other health, lifestyle, and environment

Health.md exports UV exposure, time in daylight, falls, blood alcohol, alcoholic beverages, insulin delivery, toothbrushing, handwashing, water temperature, and underwater depth.

Built

No dedicated lifestyle/environment renderer yet.

Planned

Daylight / UV calendar.
Falls timeline.
Alcohol vs sleep / HRV chart.
Insulin delivery trend.
Toothbrushing and handwashing streaks.
Water temperature / underwater depth chart.

Priority order

Generic schema-aware metric infrastructure.
Generic trend, bar, and calendar heatmap renderers.
Vitals suite: blood pressure, glucose, temperature, respiratory function.
Body composition dashboard.
Nutrition dashboard.
Symptom heatmap, leaderboard, and correlation views.
Cycle / reproductive health calendar.
Micronutrient heatmap and RDA grid.
Expanded mobility and running form dashboard.
Hearing and lifestyle/environment charts.

Last updated 2026-06-25