GitSync.md / Guides

Git & Obsidian
guides.

Start an Obsidian vault in Git, fix a failed sync, or connect your own Git server. These guides cover GitSync.md workflows on iPhone and iPad, with setup steps, screenshots, and the limits to check before you automate.

01 / Start here

Publish Obsidian notes with Quartz from your iPhone

Set up Quartz 5 and GitHub Pages once on a computer, then publish notes from your phone with a commit and push. Includes what stays private.

How to sync Obsidian with GitHub on every device

Create a private repository, set up Git and the Obsidian Git plugin on your computer, add your iPhone or Android phone, and verify both directions.

Back up an Obsidian vault with Git and restore old notes

Make Git the backup layer, include notes written on your phone, then restore a changed note, a deleted note or a folder.

How to sync Obsidian with Git on iPhone and iPad

Start with an existing GitHub vault or publish local notes. Choose your Git client, connect credentials, and verify both directions.

Sync an Obsidian vault with Git on Android

Compare the Obsidian Git plugin, Termux and a native Git client, then put the vault in a device folder Obsidian can open and verify both directions.

Create a Git repository from your iPhone

Review the files in a local folder, prepare an initial commit, and publish your vault or project to GitHub.

Set up Obsidian Git with GitSync.md Connect

Reuse your GitHub sign-in in a supported vault. Follow the screenshots and video, then verify your first pull and push.

Sync Obsidian between Windows and iPhone with GitHub

Keep a local vault on each device, publish through a private GitHub repository, and verify edits in both directions.

Git on iPad: local files or browser editing

Choose a working copy, GitHub collaboration or browser editing, then verify an edit without confusing Git with a development runtime.

Clone a GitHub repository on iPhone

Check access, choose local storage, clone the repository, and verify your first edit and push.

02 / Fix a problem

Obsidian Git not working on iPhone? Start here

Find the fix for a missing vault, repository or token error, Connect failure, conflict, or delayed automatic sync.

Set up a GitHub token in Obsidian Git on iPhone

The manual authentication route: create and paste a token, set your commit author, and verify access from the plugin.

Fix Obsidian Git merge conflicts on iPhone

Identify the Git state, preserve your notes, review each conflicting file, and finish the merge or rebase.

Obsidian .gitignore: choose what to sync

Keep device configuration local or share reviewed settings. Check which files are already tracked before pushing.

03 / Automate

Automate Git pulls with Apple Shortcuts

Trigger repository actions with App Intents, Siri, and personal automations. Understand the results and publishing controls.

Obsidian Git background sync on iPhone

Separate native Background Sync, plugin automation, Connect, Shortcuts, and Push Sync. Check what iOS timing means for your vault.

04 / Self-hosted Git and large files

Self-hosted Git with SSH on iPhone and iPad

Add a GitLab, Gitea, Forgejo, or Bitbucket remote to GitSync.md. Configure HTTPS or SSH authentication and verify host keys.

Git LFS on iPhone and iPad

Understand LFS downloads, tracking prompts, file locks, push guards, and the limits of large-file workflows.

05 / Compare sync options

GitSync vs GitSync.md: two different apps

Two unrelated apps with similar names, compared by developer, license, price, platforms, authentication and Obsidian workflow.

Best Git clients for iPhone and iPad (2026)

GitSync.md, Working Copy, Phogit, GitHub Mobile, a-Shell and iSH compared by job, push pricing and folder access.

Obsidian Sync alternatives

iCloud, Git, Syncthing, Self-hosted LiveSync and Remotely Save, sorted by the devices you own, with each option’s iPhone caveat.

GitSync.md vs Working Copy

Compare documented Obsidian workflows, folder access, Git capabilities, automation, and purchase terms.

Obsidian Sync vs Git

Compare encryption, cost, version history, and the work involved in keeping a vault synced.

iCloud vs Git for Obsidian

Choose a workflow for Apple devices or Windows and iPhone. Compare local folders, history, privacy, and switching methods.

06 / Free tools

Obsidian Sync cost calculator

Check whether your vault fits Sync Standard or needs Plus, and compare the total over 1–5 years with Git and iCloud.

Obsidian .gitignore generator

Pick what syncs between your devices and copy a commented .gitignore for your vault, with the config folder name of your choice.

Have a workflow you want documented?

Request a guide

Take your work with you.

REAL GIT.
WITHIN REACH.

Your files. Your commits. Your remote.
Get GitSync.md for iPhone, iPad, and Android.

iPhone + iPad: $9.99 once. Unlimited repositories.Android: $9.99 once. All features included.No subscriptions.