Markway

Markway is a gateway between Apple services and Markdown.

It is built around the idea that your personal data should live in plain files, not only inside apps. Markway syncs Apple Journal entries with local Markdown notes, so they can be edited, versioned, searched, linked, and extended from tools like Obsidian while still staying connected to Apple’s native apps and services.

The project currently focuses on Apple Journal: creating, reading, updating, deleting, and syncing text entries, with early support for Journal metadata and attachments. The long-term goal is broader: bring Apple services like Journal, Music, Photos, Notes, Podcasts, Health, and location history into a local Markdown-first workflow.

Markway includes a native macOS app, a command-line tool, and an Obsidian plugin. The native app handles access to Apple’s local data stores and runs the background bridge. The CLI exposes the sync engine directly. The plugin gives Obsidian a clean interface for pushing and pulling Journal entries without requiring Obsidian itself to have broad system permissions.

Obsidian Plugin Markway

The Markway Obsidian plugin connects a vault to the native Markway app.

It lets selected Markdown files sync with Apple Journal using rule-based filters, template-driven frontmatter, and commands such as pushing the current note, pulling Journal entries, and running a full Journal sync. Sync metadata is stored in the plugin’s data file rather than in the note frontmatter, so your Markdown stays clean and portable.

The plugin is desktop-only and works through the native Markway bridge instead of reading Apple data directly. This keeps Obsidian’s permission surface small while still allowing Journal sync to happen in the background.