Publish SEO articles as Markdown to GitHub (Next.js, Astro, Hugo)

GitHub

What arrives
in your repo

Works with sites that build from Markdown, like Next.js, Astro, Hugo, Nuxt, Eleventy and Jekyll, on any host that deploys when you push.

Markdown file: One file per article in your articles folder, named after its slug.
Front matter: Title, description, slug, date, image, image alt text, keywords and a draft flag.
Image: The featured image, committed to your images folder.
Commit: One commit per article, which triggers your host's normal build.

Example file

Front matter your site can read

Each article is a Markdown file like this, in content/blog by default. Folders and the image path are up to you.

---
title: "How to Choose a Coffee Subscription"
description: "What to look for in a coffee subscription, from roast dates to delivery."
slug: "how-to-choose-a-coffee-subscription"
date: "2026-11-12T09:00:00.000Z"
image: "/images/blog/how-to-choose-a-coffee-subscription.jpg"
imageAlt: "Bags of fresh coffee beans on a kitchen counter"
keywords: ["coffee subscription", "best coffee subscription"]
draft: false
---

## Start with how you brew

…

Setup ( 3 steps )

Connect GitHub
in a few minutes

Start free trial

01
Create a fine-grained token
On GitHub, go to Settings → Developer settings and create a fine-grained personal access token for just your site's repository, with Contents: Read and write.
02
Choose your folders
Pick the branch, the articles folder (content/blog by default) and the images folder (public/images/blog by default).
03
Test and publish
We check that the token can push to the branch. Each published article then becomes a commit, and your host rebuilds.

GitHub FAQ ( 3 )

Questions,
answered

Which frameworks does this work with?

Any that build pages from Markdown files: Next.js, Astro, Hugo, Nuxt Content, Eleventy, Jekyll and more. Your site decides how the front matter is used.

Does Searchloom get access to my whole GitHub account?

No. A fine-grained token can be limited to one repository and to file contents only.

What does draft mode do?

The file is still committed, with draft: true in the front matter, so your site can hide it until you change it.

More integrations