How to back up your Shopify articles as markdown

Shopify is a hosted CMS. Your articles live in Shopify’s database, your store runs on Shopify’s infrastructure, and your access to all of it depends on a login screen at admin.shopify.com. That’s mostly fine. It’s also a single point of failure for the part of the store you actually wrote: the article copy.

A locked account, an accidental deletion, an editor who overwrote the wrong article, a billing lapse, a future migration to a different platform — every one of these is a scenario where “the canonical copy of my article is in Shopify and only in Shopify” is a problem. Specter solves it as a side effect of what it already does.

Backup as a side effect of sync

Specter’s main job is two-way sync between your Shopify articles and a folder of local markdown so AI tools can edit them. The byproduct is a continuous local mirror of your article content, as plain .md files, on your Mac.

Set sync mode to “watch and sync automatically” and Specter keeps the folder up to date as you publish or edit in Shopify. Every article on your store is a file on your disk, with frontmatter at the top preserving title, handle, blog assignment, author, tags, summary, SEO title, SEO description, status, scheduled and published timestamps, and the feature image URL. The article body is standard markdown.

You didn’t do anything for this beyond installing Specter and connecting your Shopify store. The backup is just what’s already on your laptop.

What this is, honestly

A plain folder of .md files isn’t a fancy backup system. It doesn’t need to be. The properties that make it useful:

• It survives anything that isn’t your laptop. Time Machine, iCloud, Dropbox, Backblaze, Arq — whatever you already use for the rest of your Mac picks the folder up automatically.
• It survives the laptop too if you commit it to Git. Initialize the folder as a Git repo and push it to a private GitHub, GitLab, or Bitbucket repo. Every sync becomes a candidate commit. You get a full version history of your blog, by article, free.
• It’s readable without Specter. You can open any article in any text editor on any operating system, today or a decade from now. There’s no proprietary format and no lock-in.
• It’s diff-able. Two versions of an article are a git diff away. “What changed in this article between January and now?” is a one-line answer.
• It’s portable. The same markdown format Specter pulls from Shopify is the format it pushes to Ghost and WordPress. If you ever migrate, the folder is your content already in a format the next CMS can ingest.

What this is not

Just as honest:

• It’s not a full Shopify backup. Your theme is not in the folder. Your products are not in the folder. Your orders, customers, inventory, payouts, discount codes, and Shopify settings are not in the folder. Specter’s OAuth scope is articles and blogs — period. For a full-store backup, use a dedicated Shopify backup app that requests the appropriate scopes.
• It’s not a database snapshot. If something inside Shopify corrupts the article record itself (rare) and you restore by re-uploading the markdown, the article comes back with its content intact but possibly with a new internal Shopify ID. The URL handle is preserved in frontmatter, so external links keep working.
• It’s not encrypted at rest by itself. It’s a folder of plain text on your disk. Use FileVault, use an encrypted Git remote, or both, if you want encryption.

The honest framing is: it backs up the part of Shopify you actually wrote. Theme designers wrote the theme, Shopify wrote the platform, your suppliers wrote the products. The article copy is the part that’s yours, and it’s the part that’s gone the day a Shopify-side disaster wipes it. That’s what this backup covers, and it’s the part most worth covering.

Setting it up

The setup is the regular Specter setup; the backup is automatic once it’s done.

1. Install Specter. Connect via OAuth using the steps in connect your Shopify store.
2. Pick a folder somewhere you trust. Inside your normal Documents tree is fine. Inside an iCloud-synced folder is fine. Inside a Dropbox folder is fine.
3. Set sync mode to “watch and sync automatically.” Specter watches for changes in both directions in the background.
4. Run an initial full sync. Specter pulls every article down. You now have a complete local mirror.
5. (Optional but recommended.) git init the folder. Commit on a schedule — daily, weekly, or after every meaningful editing session. Push to a private remote. Now you have a versioned, off-machine copy of every article’s history.

That’s the whole setup. If your laptop or Shopify account vanishes tomorrow, the articles are still in the folder, and (if you set up Git) still in your remote.

Restoring from the folder

The reverse direction works because Specter’s sync is two-way. If you ever need to restore:

1. Install Specter on a new Mac.
2. Connect to your Shopify store the same way.
3. Point Specter at the backup folder.
4. Run the dry-run preview. You’ll see exactly which articles would be created or updated on Shopify.
5. Push.

Articles that no longer exist on Shopify are recreated. Articles that exist but differ are updated to match the local copy. The preview lets you see the blast radius before anything touches the live store — same safety net as a normal sync.

If you’re restoring after a partial disaster (one article overwritten, not the whole blog), do it the slow way: copy the relevant version of the .md file from your Git history into the working folder, let Specter detect the change, preview, and push only that article.

Where this fits

The backup is one of three honest reasons to keep a local markdown mirror of your Shopify articles, and the one that takes zero ongoing effort. The other two are why most people install Specter in the first place:

• Editing with AI. Plain markdown is what every AI tool already understands — the workflow is in the Claude guide.
• Bulk SEO work. A folder of markdown is exactly the input a script or AI wants for sweeping SEO updates across the archive.

The backup is what happens for free while you’re doing those things.

The mental model

Your articles live in two places now: in Shopify, where they render and serve traffic, and in a folder on your Mac, where you can read them, edit them, version them, and survive any disaster that doesn’t take out your laptop and your Git remote simultaneously. Plain text outlives platforms. That’s the whole point.