sync.md

A native iOS & iPadOS app that turns any GitHub repository into a synced markdown vault.

Sync.md clones GitHub repos directly to your iPhone or iPad using libgit2, giving you a real .git directory on the device filesystem. Edit markdown files with any app — Obsidian, ia Writer, or the built-in Files app — then pull and push changes back to GitHub.

Key Features

• Real git — Clone, pull, commit, and push via libgit2. No REST API workarounds, no proprietary sync.
• Multiple repos — Manage several GitHub repositories at once.
• Custom save locations — Store repos anywhere accessible via the Files app.
• Obsidian integration — Works with Obsidian vaults via x-callback-url for automated sync.
• GitHub OAuth & PAT — Sign in with GitHub OAuth or paste a Personal Access Token.
• Private repo support — Works with both public and private repositories.
• iPad support — Optimized layouts for iPad.

How It Works

1. Sign in with GitHub (OAuth or Personal Access Token)
2. Pick a repository from your GitHub account
3. Clone it to your device — files appear in the iOS Files app
4. Edit with any markdown editor
5. Pull to fetch remote changes, Push to commit and upload yours

x-callback-url API

External apps can trigger sync operations:

syncmd://x-callback-url/<action>?repo=<folder-name>&x-success=<url>&x-error=<url>