RepoPress

Publish your WordPress content straight from a GitHub repository.
Write in Markdown, keep it under version control, and let your posts stay in sync from the branch you choose.

---

What it does

RepoPress reads Markdown files from a GitHub repository and turns them into WordPress posts. Point it at a repo, a branch, and a folder, and every Markdown file there becomes a post. Edit a file on GitHub, and the matching post updates on the next sync.

It fits three kinds of people well:

• You like writing in Markdown and would rather not touch the WordPress editor.
• You want your content under version control, with history and pull requests.
• You manage docs, release notes, or a changelog in a repo and need them mirrored onto a WordPress site.

Why one direction

Your repository is the source of truth. WordPress is where it gets published. RepoPress only reads from GitHub, it never writes back, so there is nothing to reconcile and no chance of the plugin changing your repo. That decision keeps the whole thing predictable: if the file changed, the post changes; if it did not, nothing happens.

How it works

  GitHub repo (Markdown + front matter)
            │
            │  read-only, over the GitHub REST API
            ▼
  RepoPress  ──►  parse front matter  ──►  convert Markdown to HTML
            │
            ▼
  WordPress posts  (tracked per file by its Git blob checksum)

Each file is tracked by its Git blob SHA, stored in post meta. On every run RepoPress compares the current SHA against the last one it saw, so unchanged files are skipped and only real edits trigger an update. No content diffing, no guesswork.

A sample file

Front matter drives the post. Everything below it is the body.

---
title: "Getting Started"
slug: getting-started
status: publish
type: post
categories: [Guides, Tutorials]
tags:
  - setup
  - intro
excerpt: A short intro that becomes the post excerpt.
date: 2026-08-14
---

# Getting Started

Your **Markdown** body goes here, including lists, links, and code.

Front matter reference

Key	Maps to	Notes
title	Post title	Falls back to the first # heading, then the filename
slug	Post slug	Optional
status	Post status	publish, draft, pending, private. Defaults to the plugin setting
type	Post type	Any registered public type. Defaults to the plugin setting
categories	Categories	Inline [A, B] or a block list. Created if missing
tags	Tags	Inline or block list
excerpt	Post excerpt	Optional
date	Publish date	Any format PHP can parse

Installation

From the WordPress plugin directory

1. In your dashboard, go to Plugins → Add New and search for RepoPress.
2. Install and activate.

Manual

1. Download the latest release zip.
2. Plugins → Add New → Upload Plugin, choose the zip, install, and activate.

For development

git clone https://github.com/gunjanjaswal/RepoPress.git wp-content/plugins/repopress

RepoPress ships with a bundled Markdown parser, so it runs as-is. If you prefer Composer, composer install will use the Composer copy instead.

Setup

1. Go to Tools → RepoPress.
2. Enter the repository owner, name, branch, and an optional folder path.
3. Paste a fine-grained personal access token with read-only Contents access to that repository.
4. Choose the post type, default status, and how often to sync.
5. Click Test connection, then Sync now.

The token

RepoPress needs a fine-grained personal access token scoped to the one repository, with Contents: Read-only. That is the least access the plugin can work with. The token is stored encrypted in your database.

Configuration

Setting	What it controls
Owner / Repository / Branch	Where content is read from
Folder path	Limit syncing to a sub-folder, or leave empty for the repo root
Post type	Default type for imported files
Default status	Status used when a file omits status
Automatic sync	Manual, every 15 minutes, hourly, twice daily, or daily (via WP-Cron)
When a file is deleted	Leave the post untouched (log only), or move it to Trash

Frequently asked questions

Does it write my WordPress posts back to GitHub? No. Version 0.1 is read-only from GitHub to WordPress. Your repo is never modified.

What happens when I delete a file from the repo? By default the matching post is left alone and the event is logged. You can switch to moving that post to Trash in the settings.

Does it work with the block editor and page builders? Content is stored as HTML in the post body, which the block editor and any theme read fine. Builders that keep their own layout data, such as Elementor or WPBakery, own the editing surface for a page, so synced content shows as standard content rather than editable builder modules.

Is my token safe? It is stored encrypted at rest using your site's authentication salts, and it never leaves your server except in calls to the GitHub API.

External services

RepoPress talks to the GitHub REST API (https://api.github.com) to read the repository you configure. Requests are made only after you save a repository and token, and only to fetch the repository details, its file tree, and the contents of Markdown files. Nothing is sent anywhere else, and the plugin collects no analytics.

• GitHub Terms of Service
• GitHub Privacy Statement

Roadmap

Version	Focus
0.1	One-way pull, PAT auth, manual and scheduled sync, front matter mapping, change detection, activity log
0.2	Push webhooks for instant sync; WordPress to GitHub export; image and asset handling
0.3	Optional GitHub App and Marketplace listing; multi-repo; block-based rendering

Development

See CONTRIBUTING.md for local setup, coding standards, the versioning scheme, and the release process.

# lint every PHP file
find . -name '*.php' -not -path './vendor/*' -print0 | xargs -0 -n1 php -l

Contributing

Issues and pull requests are welcome at github.com/gunjanjaswal/RepoPress. If you are reporting a bug, a sample Markdown file and your settings help a lot.

License

GPL-2.0-or-later. See LICENSE. The bundled Markdown parser, Parsedown, is MIT licensed; its license sits alongside it in includes/lib/.

Author

Built by Gunjan Jaswal.

• Website: gunjanjaswal.me
• Email: hello@gunjanjaswal.me
• Support the work: ko-fi.com/gunjanjaswal